DateTimeOffset.LocalDateTime Propriété

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Obtient une valeur DateTime représentant la date et l'heure locales de l'objet DateTimeOffset en cours.

C#

public DateTime LocalDateTime { get; }

Valeur de propriété

DateTime

Date et heure locales de l'objet DateTimeOffset actuel.

Exemples

L’exemple suivant illustre plusieurs conversions de DateTimeOffset valeurs en heures locales dans le fuseau horaire standard des États-Unis. Notez que les trois dernières fois sont ambiguës; la propriété les mappe toutes à une seule date et heure dans le fuseau horaire standard du Pacifique.

C#

 DateTimeOffset dto;

 // Current time
 dto = DateTimeOffset.Now;
 Console.WriteLine(dto.LocalDateTime);
 // UTC time
 dto = DateTimeOffset.UtcNow;
 Console.WriteLine(dto.LocalDateTime);

// Transition to DST in local time zone occurs on 3/11/2007 at 2:00 AM
 dto = new DateTimeOffset(2007, 3, 11, 3, 30, 0, new TimeSpan(-7, 0, 0));
 Console.WriteLine(dto.LocalDateTime);
 dto = new DateTimeOffset(2007, 3, 11, 2, 30, 0, new TimeSpan(-7, 0, 0));
 Console.WriteLine(dto.LocalDateTime);
 // Invalid time in local time zone
 dto = new DateTimeOffset(2007, 3, 11, 2, 30, 0, new TimeSpan(-8, 0, 0));
 Console.WriteLine(TimeZoneInfo.Local.IsInvalidTime(dto.DateTime));
 Console.WriteLine(dto.LocalDateTime);

 // Transition from DST in local time zone occurs on 11/4/07 at 2:00 AM
 // This is an ambiguous time
 dto = new DateTimeOffset(2007, 11, 4, 1, 30, 0, new TimeSpan(-7, 0, 0));
 Console.WriteLine(TimeZoneInfo.Local.IsAmbiguousTime(dto));
 Console.WriteLine(dto.LocalDateTime);
 dto = new DateTimeOffset(2007, 11, 4, 2, 30, 0, new TimeSpan(-7, 0, 0));
 Console.WriteLine(TimeZoneInfo.Local.IsAmbiguousTime(dto));
 Console.WriteLine(dto.LocalDateTime);
 // This is also an ambiguous time
 dto = new DateTimeOffset(2007, 11, 4, 1, 30, 0, new TimeSpan(-8, 0, 0));
 Console.WriteLine(TimeZoneInfo.Local.IsAmbiguousTime(dto));
 Console.WriteLine(dto.LocalDateTime);
 // If run on 3/8/2007 at 4:56 PM, the code produces the following
 // output:
 //    3/8/2007 4:56:03 PM
 //    3/8/2007 4:56:03 PM
 //    3/11/2007 3:30:00 AM
 //    3/11/2007 1:30:00 AM
 //    True
 //    3/11/2007 3:30:00 AM
 //    True
 //    11/4/2007 1:30:00 AM
 //    11/4/2007 1:30:00 AM
 //    True
 //    11/4/2007 1:30:00 AM

Remarques

Si nécessaire, la LocalDateTime propriété convertit la date et l’heure de l’objet actuel DateTimeOffset en date et heure du système local. La conversion est une opération en deux étapes :

1. La propriété convertit l’heure de l’objet actuel DateTimeOffset en heure universelle coordonnée (UTC).

2. La propriété convertit ensuite UTC en heure locale.

Il n’y a pas de temps non valide et les heures ambiguës sont mappées à l’heure standard du fuseau local. (Toutefois, la conversion peut créer une anomalie : si une DateTimeOffset valeur dérivée de l’ordinateur local reflète une date et une heure ambiguës, cette valeur peut être convertie en UTC, puis revenir à une heure locale qui diffère de l’heure d’origine.) La propriété applique toutes les règles d’ajustement dans le fuseau horaire local lorsqu’elle effectue cette conversion.

Cette propriété retourne à la fois la date et le composant d’heure d’un DateTimeOffset objet, ce qui le rend utile pour DateTimeOffset la DateTime conversion. En plus d’effectuer toute conversion de temps nécessaire, cette propriété diffère de la DateTime propriété en définissant la valeur de la Kind propriété de l’objet DateTimeKind.Localretourné DateTime sur .

S’applique à

Voir aussi

• DateTime