DateTime.ToFileTimeUtc Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Converteert de waarde van het huidige DateTime-object naar een Windows bestandstijd.
public:
long ToFileTimeUtc();public long ToFileTimeUtc();member this.ToFileTimeUtc : unit -> int64Public Function ToFileTimeUtc () As LongRetouren
De waarde van het huidige DateTime-object uitgedrukt als een Windows bestandstijd.
Uitzonderingen
De resulterende bestandstijd vertegenwoordigt een datum en tijd vóór 12:00 middernacht 1 januari 1601 C.E. UTC.
Opmerkingen
Een Windows bestandstijd is een 64-bits waarde die het aantal intervallen van 100 nanoseconden aangeeft dat is verstreken sinds 12:00 middernacht, 1 januari 1601 A.D. (C.E.) Coordinated Universal Time (UTC). Windows gebruikt een bestandstijd om op te nemen wanneer een toepassing een bestand maakt, opent of schrijft naar een bestand.
De ToFileTimeUtc methode gebruikt de Kind eigenschap om te bepalen of het huidige DateTime object een lokale tijd, een UTC-tijd of een niet-opgegeven soort tijd is, die wordt behandeld als een UTC-tijd. Als het een lokale tijd is, wordt de tijd geconverteerd naar UTC voordat de conversie wordt uitgevoerd naar een Windows bestandstijd.
Notities voor bellers
De ToFileTimeUtc() methode wordt soms gebruikt om een lokale tijd te converteren naar UTC en vervolgens om deze te herstellen door de FromFileTimeUtc(Int64) methode aan te roepen, gevolgd door de ToLocalTime() methode. Als de oorspronkelijke tijd echter een ongeldige tijd in de lokale tijdzone vertegenwoordigt, zijn de twee lokale tijdwaarden niet gelijk. Zie de ToLocalTime() methode voor meer informatie.
