dotnet / dotnet/dotnet-api-docs
DateTimeOffset.Subtraction Remarks Example Contains Minor Discrepancy
- 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
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