dotnet / dotnet/dotnet-api-docs

Incorrect Example

Aperta
#1,607 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
area-System.DateTime dotnet-api/prod Pri2 untriaged
Lingua principale
C#
Stelle
949
Fork
1.7k
Merge medio
2g 19h
PR unite (30g)
52

Descrizione

In example above, "24:0:0" is said to return "Parse operation failed". It's incorrect.
It succeeds and returns 24 days ...
As it's definitely an edge-case not behaving as expected (some could have expect 1 day). It's better to document it properly.

See :
https://github.com/dotnet/dotnet-api-docs/blob/7f6a3882631bc008b858adfadb43cd17bbd55d49/xml/System/TimeSpan.xml#L2772

---
#### Document Details

⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.*

* ID: 26b52684-e2ce-3140-893f-1230bc2eeb3d
* Version Independent ID: 082096cb-4250-a700-725d-c8f99eb96ff8
* Content: [TimeSpan.TryParse Method (System)](https://docs.microsoft.com/en-us/dotnet/api/system.timespan.tryparse?view=netframework-4.7.2)
* Content Source: [xml/System/TimeSpan.xml](https://github.com/dotnet/dotnet-api-docs/blob/master/xml/System/TimeSpan.xml)
* Product: **dotnet-api**
* GitHub Login: @dotnet-bot
* Microsoft Alias: **dotnetcontent**

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Apri xml/System/TimeSpan.xml intorno alla riga 2772 e rivedi l'esempio di TimeSpan.TryParse per "24:0:0". Verifica che il risultato indicato nell'esempio corrisponda al comportamento documentato, quindi aggiorna l'esempio in modo da descrivere accuratamente il parsing riuscito e il valore restituito di 24 giorni.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
csharp
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
1/5
Tempo stimato
Meno di un'ora
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
55/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.