dotnet / dotnet/dotnet-api-docs

DateTimeOffset.Subtraction Remarks Example Contains Minor Discrepancy

Offen
#9,537 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
area-System.DateTime Pri3
Vorherrschende Sprache
C#
Sterne
949
Forks
1.7k
Ø Merge
2 T. 19 Std.
Gemergte PRs (30 T.)
52

Beschreibung

_This issue has been moved from [a ticket on Developer Community](https://developercommunity.visualstudio.com/t/DateTimeOffsetSubtraction-Remarks-Examp/10552416)._

---
[severity:It bothers me. A fix would be nice]
[DateTimeOffset.Subtraction](https://learn.microsoft.com/en-us/dotnet/api/system.datetimeoffset.op_subtraction?view=net-8.0#system-datetimeoffset-op-subtraction(system-datetimeoffset-system-datetimeoffset)) Remarks section example has a minor discrepancy.

Original
```
difference = firstDate - thirdDate;
Console.WriteLine("({0}) - ({1}): {2} days, {3}:{4:d2}",
firstDate.ToString(),
secondDate.ToString(),
difference.Days,
difference.Hours,
difference.Minutes);
// The example produces the following output:
// (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 0 days, 2:00
// (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 26 days, 9:00
```
When calculating the difference the second time, the output uses **secondDate** where it should use **thirdDate**.

Updated

```
difference = firstDate - thirdDate;
Console.WriteLine("({0}) - ({1}): {2} days, {3}:{4:d2}",
firstDate.ToString(),
thirdDate.ToString(),
difference.Days,
difference.Hours,
difference.Minutes);
// The example produces the following output:
// (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 0 days, 2:00
// (3/25/2008 6:00:00 PM -07:00) - (2/28/2008 9:00:00 PM -07:00): 26 days, 9:00
```

---
### Original Comments

#### Feedback Bot on 1/3/2024, 05:51 PM:

(private comment, text removed)

---
### Original Solutions
(no solutions)

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Suchen Sie im Repository dotnet-api-docs nach dem Beispiel im Abschnitt Remarks der API DateTimeOffset.Subtraction. Vergleichen Sie die zweite Berechnung und ihre erwartete Ausgabe mit dem korrigierten Beispiel des Issues und überprüfen Sie anschließend, ob die gerenderte Dokumentation das übereinstimmende Datum und die übereinstimmende Ausgabe zeigt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
csharp
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Aktivitätsstatus
Veraltet
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
45/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.