DateTimeOffset.Implicit(DateTime to DateTimeOffset) Opérateur

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

DateTimeOffset.cs

Définit une conversion implicite d'un objet DateTime en objet DateTimeOffset.

public:
 static operator DateTimeOffset(DateTime dateTime);

public static implicit operator DateTimeOffset (DateTime dateTime);

static member op_Implicit : DateTime -> DateTimeOffset

Public Shared Widening Operator CType (dateTime As DateTime) As DateTimeOffset

Paramètres

dateTime

DateTime

Objet à convertir.

Retours

DateTimeOffset

Objet converti.

Exceptions

ArgumentOutOfRangeException

La date et l’heure UTC (Coordinated Universal Time) qui résultent de l’application du décalage sont antérieures à DateTimeOffset.MinValue.

-ou-

La date et l’heure UTC qui résultent de l’application du décalage sont postérieures à DateTimeOffset.MaxValue.

Remarques

La Implicit méthode permet au compilateur de convertir automatiquement un DateTime objet en objet DateTimeOffset sans opérateur de cast explicite (en C#) ou un appel à une fonction de conversion (en Visual Basic). Il définit une conversion étendue qui n’implique pas de perte de données et ne lève pas de OverflowException. Le Implicit méthode rend le code tel que :

DateTimeOffset timeWithOffset;
timeWithOffset = new DateTime(2008, 7, 3, 18, 45, 0);
Console.WriteLine(timeWithOffset.ToString());

timeWithOffset = DateTime.UtcNow;
Console.WriteLine(timeWithOffset.ToString());

timeWithOffset = DateTime.SpecifyKind(DateTime.Now,
                                      DateTimeKind.Unspecified);
Console.WriteLine(timeWithOffset.ToString());

timeWithOffset = new DateTime(2008, 7, 1, 2, 30, 0) +
                       new TimeSpan(1, 0, 0, 0);
Console.WriteLine(timeWithOffset.ToString());

timeWithOffset = new DateTime(2008, 1, 1, 2, 30, 0);
Console.WriteLine(timeWithOffset.ToString());
// The example produces the following output if run on 3/20/2007
// at 6:25 PM on a computer in the U.S. Pacific Daylight Time zone:
//       7/3/2008 6:45:00 PM -07:00
//       3/21/2007 1:25:52 AM +00:00
//       3/20/2007 6:25:52 PM -07:00
//       7/2/2008 2:30:00 AM -07:00
//       1/1/2008 2:30:00 AM -08:00
//
// The last example shows automatic adaption to the U.S. Pacific Time
// for winter dates.

let timeWithOffset = DateTime(2008, 7, 3, 18, 45, 0)
printfn $"{timeWithOffset}"

let timeWithOffset = DateTime.UtcNow
printfn $"{timeWithOffset}"

let timeWithOffset =
    DateTime.SpecifyKind(DateTime.Now, DateTimeKind.Unspecified)

printfn $"{timeWithOffset}"

let timeWithOffset =
    DateTime(2008, 7, 1, 2, 30, 0)
    + TimeSpan(1, 0, 0, 0)

printfn $"{timeWithOffset}"

let timeWithOffset = DateTime(2008, 1, 1, 2, 30, 0)
printfn $"{timeWithOffset}"

// The example produces the following output if run on 3/20/2007
// at 6:25 PM on a computer in the U.S. Pacific Daylight Time zone:
//       7/3/2008 6:45:00 PM -07:00
//       3/21/2007 1:25:52 AM +00:00
//       3/20/2007 6:25:52 PM -07:00
//       7/2/2008 2:30:00 AM -07:00
//       1/1/2008 2:30:00 AM -08:00
//
// The last example shows automatic adaption to the U.S. Pacific Time
// for winter dates.

   Dim timeWithOffset As DateTimeOffset 
   timeWithOffset = #07/03/2008 6:45PM#
   Console.WriteLine(timeWithOffset.ToString())
   
   timeWithOffset = Date.UtcNow
   Console.WriteLine(timeWithOffset.ToString())
   
   timeWithOffset = Date.SpecifyKind(Date.Now, DateTimeKind.Unspecified)
   Console.WriteLine(timeWithOffset.ToString())

   timeWithOffset = #07/01/2008 2:30AM# + New TimeSpan(1, 0, 0, 0)
   Console.WriteLine(timeWithOffset.ToString())
     
   timeWithOffset = #01/01/2008 2:30AM#
   Console.WriteLine(timeWithOffset.ToString())
   ' The example produces the following output if run on 3/20/2007 
   ' at 6:25 PM on a computer in the U.S. Pacific Daylight Time zone:
   '       7/3/2008 6:45:00 PM -07:00
   '       3/21/2007 1:25:52 AM +00:00
   '       3/20/2007 6:25:52 PM -07:00
   '       7/2/2008 2:30:00 AM -07:00
   '       1/1/2008 2:30:00 AM -08:00
   '
   ' The last example shows automatic adaption to the U.S. Pacific Time
   ' for winter dates.

Cette méthode est équivalente au DateTimeOffset constructeur. Le décalage de l’objet résultant DateTimeOffset dépend de la valeur de la DateTime.Kind propriété du dateTime paramètre :

• Si la valeur de la DateTime.Kind propriété est DateTimeKind.Utc, la date et l’heure de l’objet DateTimeOffset sont définies sur dateTime, et sa Offset propriété est définie sur 0.

• Si la valeur de la DateTime.Kind propriété est DateTimeKind.Local ou DateTimeKind.Unspecified, la date et l’heure de l’objet DateTimeOffset sont définies sur dateTime, et sa Offset propriété est définie sur le décalage du fuseau horaire actuel du système local.

La méthode équivalente pour cet opérateur est DateTimeOffset.DateTimeOffset(DateTime)