DateTimeOffset Constructeurs

Référence

Définition

Espace de noms:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise une nouvelle instance de la structure DateTimeOffset.

Surcharges

DateTimeOffset(DateTime)	Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de la valeur DateTime spécifiée.
DateTimeOffset(DateTime, TimeSpan)	Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de la valeur et du décalage DateTime spécifiés.
DateTimeOffset(Int64, TimeSpan)	Initialise une nouvelle instance de la structure DateTimeOffset à l’aide du nombre spécifié de graduations et de décalage.
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Initialise une nouvelle instance de la structure DateTimeOffset à l’aide des `date`, `time`et `offset`spécifiés.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de l’année, du mois, du jour, de l’heure, de la minute, de la seconde et du décalage spécifiés.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de l’année, du mois, du jour, de l’heure, de la minute, de la seconde, de la milliseconde et du décalage spécifiés.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de l’année, du mois, du jour, de l’heure, de la minute, de la seconde, de la milliseconde et du décalage d’un calendrier spécifié.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Initialise une nouvelle instance de la structure DateTimeOffset à l’aide des `year`, `month`, `day`, `hour`, `minute`, `second`, `millisecond`, `microsecond` et `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Initialise une nouvelle instance de la structure DateTimeOffset à l’aide des `year`, `month`, `day`, `hour`, `minute`, `second`, `millisecond`, `microsecond` et `offset`.

DateTimeOffset(DateTime)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de la valeur DateTime spécifiée.

public:
 DateTimeOffset(DateTime dateTime);

public DateTimeOffset (DateTime dateTime);

new DateTimeOffset : DateTime -> DateTimeOffset

Public Sub New (dateTime As DateTime)

Paramètres

dateTime: DateTime

Date et heure.

Exceptions

ArgumentOutOfRangeException

La date et l’heure UTC (Temps universel coordonné) qui résulte de l’application du décalage sont antérieures à DateTimeOffset.MinValue.

-ou-

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

Exemples

L’exemple suivant montre comment la valeur de la propriété DateTime.Kind du paramètre dateTime affecte la valeur de date et d’heure retournée par ce constructeur.

DateTime localNow = DateTime.Now;
DateTimeOffset localOffset = new DateTimeOffset(localNow);
Console.WriteLine(localOffset.ToString());

DateTime utcNow = DateTime.UtcNow;
DateTimeOffset utcOffset = new DateTimeOffset(utcNow);
Console.WriteLine(utcOffset.ToString());

DateTime unspecifiedNow = DateTime.SpecifyKind(DateTime.Now,
                               DateTimeKind.Unspecified);
DateTimeOffset unspecifiedOffset = new DateTimeOffset(unspecifiedNow);
Console.WriteLine(unspecifiedOffset.ToString());
//
// The code produces the following output if run on Feb. 23, 2007, on
// a system 8 hours earlier than UTC:
//   2/23/2007 4:21:58 PM -08:00
//   2/24/2007 12:21:58 AM +00:00
//   2/23/2007 4:21:58 PM -08:00

let localNow = DateTime.Now
let localOffset = DateTimeOffset localNow
printfn $"{localOffset}"

let utcNow = DateTime.UtcNow
let utcOffset = DateTimeOffset utcNow
printfn "{utcOffset}"

let unspecifiedNow = DateTime.SpecifyKind(DateTime.Now, DateTimeKind.Unspecified)
let unspecifiedOffset = DateTimeOffset unspecifiedNow
printfn $"{unspecifiedOffset}"

// The code produces the following output if run on Feb. 23, 2007, on
// a system 8 hours earlier than UTC:
//   2/23/2007 4:21:58 PM -08:00
//   2/24/2007 12:21:58 AM +00:00
//   2/23/2007 4:21:58 PM -08:00

Dim localNow As Date = Date.Now
Dim localOffset As New DateTimeOffset(localNow)
Console.WriteLine(localOffset.ToString())

Dim utcNow As Date = Date.UtcNow
Dim utcOffset As New DateTimeOffset(utcNow)
Console.WriteLine(utcOffset.ToString())

Dim unspecifiedNow As Date = Date.SpecifyKind(Date.Now, _
                                  DateTimeKind.Unspecified)
Dim unspecifiedOffset As New DateTimeOffset(unspecifiedNow)
Console.WriteLine(unspecifiedOffset.ToString())
'
' The code produces the following output if run on Feb. 23, 2007, on
' a system 8 hours earlier than UTC:
'    2/23/2007 4:21:58 PM -08:00
'    2/24/2007 12:21:58 AM +00:00
'    2/23/2007 4:21:58 PM -08:00

Remarques

Le comportement de ce constructeur dépend de la valeur de la propriété DateTime.Kind du paramètre dateTime :

Si la valeur de DateTime.Kind est DateTimeKind.Utc, la propriété DateTime de la nouvelle instance est définie sur dateTimeet la propriété Offset est définie sur Zero.
Si la valeur de DateTime.Kind est DateTimeKind.Local ou DateTimeKind.Unspecified, la propriété DateTime de la nouvelle instance est définie sur dateTimeet la propriété Offset est définie sur le décalage du fuseau horaire actuel du système local.

Voir aussi

instanciation d’un objet DateTimeOffset

S’applique à

DateTimeOffset(DateTime, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de la valeur et du décalage DateTime spécifiés.

public:
 DateTimeOffset(DateTime dateTime, TimeSpan offset);

public DateTimeOffset (DateTime dateTime, TimeSpan offset);

new DateTimeOffset : DateTime * TimeSpan -> DateTimeOffset

Public Sub New (dateTime As DateTime, offset As TimeSpan)

Paramètres

dateTime: DateTime

Date et heure.

offset: TimeSpan

Décalage de l’heure par rapport au temps universel coordonné (UTC).

Exceptions

ArgumentException

dateTime.Kind est égal à Utc et offset n’est pas égal à zéro.

-ou-

dateTime.Kind est égal à Local et offset n’est pas égal au décalage du fuseau horaire local du système.

-ou-

offset n’est pas spécifié en minutes entières.

ArgumentOutOfRangeException

offset est inférieur à -14 heures ou supérieure à 14 heures.

-ou-

UtcDateTime est inférieur à DateTimeOffset.MinValue ou supérieur à DateTimeOffset.MaxValue.

Exemples

L’exemple suivant montre comment initialiser un objet DateTimeOffset avec une date et une heure et le décalage du fuseau horaire local lorsque ce fuseau horaire n’est pas connu à l’avance.

DateTime localTime = new DateTime(2007, 07, 12, 06, 32, 00);
DateTimeOffset dateAndOffset = new DateTimeOffset(localTime,
                         TimeZoneInfo.Local.GetUtcOffset(localTime));
Console.WriteLine(dateAndOffset);
// The code produces the following output:
//    7/12/2007 6:32:00 AM -07:00

let localTime = DateTime(2007, 07, 12, 06, 32, 00)
let dateAndOffset = DateTimeOffset(localTime, TimeZoneInfo.Local.GetUtcOffset localTime)
printfn $"{dateAndOffset}"
// The code produces the following output:
//    7/12/2007 6:32:00 AM -07:00

Dim localTime As Date = #07/12/2007 6:32AM#
Dim dateAndOffset As New DateTimeOffset(localTime, _
                         TimeZoneInfo.Local.GetUtcOffset(localTime))
Console.WriteLine(dateAndOffset)
' The code produces the following output:
'    7/12/2007 6:32:00 AM -07:00

Remarques

Le comportement de ce constructeur dépend en partie de la valeur de la propriété Kind du paramètre dateTime :

Si la valeur de Kind est DateTimeKind.Utc, la valeur du paramètre offset doit être 0 ou une ArgumentException est levée.
Si la valeur de Kind est DateTimeKind.Local, la valeur du paramètre offset doit être égale au décalage du fuseau horaire local par rapport au temps universel coordonné (UTC) pour cette date particulière ou une ArgumentException est levée.
Si la valeur de Kind est DateTimeKind.Unspecified, le paramètre offset peut avoir n’importe quelle valeur valide.

Voir aussi

instanciation d’un objet DateTimeOffset

S’applique à

DateTimeOffset(Int64, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la structure DateTimeOffset à l’aide du nombre spécifié de graduations et de décalage.

public:
 DateTimeOffset(long ticks, TimeSpan offset);

public DateTimeOffset (long ticks, TimeSpan offset);

new DateTimeOffset : int64 * TimeSpan -> DateTimeOffset

Public Sub New (ticks As Long, offset As TimeSpan)

Paramètres

ticks: Int64

Date et heure exprimées sous la forme du nombre d’intervalles de 100 nanosecondes écoulés depuis 12:00:00 minuit le 1er janvier 0001.

offset: TimeSpan

Décalage de l’heure par rapport au temps universel coordonné (UTC).

Exceptions

ArgumentException

offset n’est pas spécifié en minutes entières.

ArgumentOutOfRangeException

La propriété UtcDateTime est antérieure à DateTimeOffset.MinValue ou ultérieure à DateTimeOffset.MaxValue.

-ou-

ticks est inférieur à DateTimeOffset.MinValue.Ticks ou supérieur à DateTimeOffset.MaxValue.Ticks.

-ou-

offset est inférieur à -14 heures ou supérieure à 14 heures.

Exemples

L’exemple suivant initialise un objet DateTimeOffset à l’aide du nombre de graduations dans une date arbitraire (dans ce cas, le 16 juillet 2007, à 13 h 32) avec un décalage de -5.

DateTime dateWithoutOffset = new DateTime(2007, 7, 16, 13, 32, 00);
DateTimeOffset timeFromTicks = new DateTimeOffset(dateWithoutOffset.Ticks,
                               new TimeSpan(-5, 0, 0));
Console.WriteLine(timeFromTicks.ToString());
// The code produces the following output:
//    7/16/2007 1:32:00 PM -05:00

let dateWithoutOffset = DateTime(2007, 7, 16, 13, 32, 00)
let timeFromTicks = DateTimeOffset(dateWithoutOffset.Ticks, TimeSpan(-5, 0, 0))
printfn $"{timeFromTicks}"
// The code produces the following output:
//    7/16/2007 1:32:00 PM -05:00

Dim dateWithoutOffset As Date = #07/16/2007 1:32PM#
Dim timeFromTicks As New DateTimeOffset(datewithoutOffset.Ticks, _
                         New TimeSpan(-5, 0, 0))
Console.WriteLine(timeFromTicks.ToString())
' The code produces the following output:
'    7/16/2007 1:32:00 PM -05:00

Remarques

En règle générale, essayant d’appeler le constructeur DateTimeOffset pour instancier une valeur DateTimeOffset avec une heure locale et un décalage autre que celui du fuseau horaire local lève une ArgumentException. Vous pouvez utiliser cette surcharge du constructeur DateTimeOffset pour contourner cette limitation. L’exemple suivant utilise le nombre de graduations de l’heure locale pour instancier une valeur DateTimeOffset dont le décalage ne représente pas nécessairement celui de l’heure locale :

DateTime localTime = DateTime.Now;
DateTimeOffset nonLocalDateWithOffset = new DateTimeOffset(localTime.Ticks,
                                  new TimeSpan(2, 0, 0));
Console.WriteLine(nonLocalDateWithOffset);
//
// The code produces the following output if run on Feb. 23, 2007:
//    2/23/2007 4:37:50 PM +02:00

let localTime = DateTime.Now
let nonLocalDateWithOffset = DateTimeOffset(localTime.Ticks, TimeSpan(2, 0, 0))
printfn $"{nonLocalDateWithOffset}"
// The code produces the following output if run on Feb. 23, 2007:
//    2/23/2007 4:37:50 PM +02:00

Dim localTime As Date = Date.Now
Dim nonLocalDateWithOffset As New DateTimeOffset(localTime.Ticks, _
                                  New TimeSpan(2, 0, 0))
Console.WriteLine(nonLocalDateWithOffset)                                        
'
' The code produces the following output if run on Feb. 23, 2007:
'    2/23/2007 4:37:50 PM +02:00

Voir aussi

instanciation d’un objet DateTimeOffset

S’applique à

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la structure DateTimeOffset à l’aide des date, timeet offsetspécifiés.

public:
 DateTimeOffset(DateOnly date, TimeOnly time, TimeSpan offset);

public DateTimeOffset (DateOnly date, TimeOnly time, TimeSpan offset);

new DateTimeOffset : DateOnly * TimeOnly * TimeSpan -> DateTimeOffset

Public Sub New (date As DateOnly, time As TimeOnly, offset As TimeSpan)

Paramètres

date: DateOnly

Partie de date.

time: TimeOnly

La partie de temps.

offset: TimeSpan

Décalage de l’heure par rapport au temps universel coordonné (UTC).

S’applique à

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de l’année, du mois, du jour, de l’heure, de la minute, de la seconde et du décalage spécifiés.

public:
 DateTimeOffset(int year, int month, int day, int hour, int minute, int second, TimeSpan offset);

public DateTimeOffset (int year, int month, int day, int hour, int minute, int second, TimeSpan offset);

new DateTimeOffset : int * int * int * int * int * int * TimeSpan -> DateTimeOffset

Public Sub New (year As Integer, month As Integer, day As Integer, hour As Integer, minute As Integer, second As Integer, offset As TimeSpan)

Paramètres

year: Int32

L’année (1 à 9999).

month: Int32

Mois (1 à 12).

day: Int32

Jour (1 au nombre de jours en month).

hour: Int32

Les heures (0 à 23).

minute: Int32

Minutes (0 à 59).

second: Int32

Secondes (0 à 59).

offset: TimeSpan

Décalage de l’heure par rapport au temps universel coordonné (UTC).

Exceptions

ArgumentException

offset ne représente pas les minutes entières.

ArgumentOutOfRangeException

year est inférieur à un ou supérieur à 9999.

-ou-

month est inférieur à un ou supérieur à 12.

-ou-

day est inférieur à un ou supérieur au nombre de jours dans month.

-ou-

hour est inférieur à zéro ou supérieur à 23.

-ou-

minute est inférieur à 0 ou supérieur à 59.

-ou-

second est inférieur à 0 ou supérieur à 59.

-ou-

offset est inférieur à -14 heures ou supérieure à 14 heures.

-ou-

La propriété UtcDateTime est antérieure à DateTimeOffset.MinValue ou ultérieure à DateTimeOffset.MaxValue.

Exemples

L’exemple suivant instancie un objet DateTimeOffset à l’aide de la surcharge du constructeur DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan).

   DateTime specificDate = new DateTime(2008, 5, 1, 06, 32, 00);
   DateTimeOffset offsetDate = new DateTimeOffset(specificDate.Year,
                                   specificDate.Month,
                                   specificDate.Day,
                                   specificDate.Hour,
                                   specificDate.Minute,
                                   specificDate.Second,
                                   new TimeSpan(-5, 0, 0));
   Console.WriteLine("Current time: {0}", offsetDate);
   Console.WriteLine("Corresponding UTC time: {0}", offsetDate.UtcDateTime);
// The code produces the following output:
//    Current time: 5/1/2008 6:32:00 AM -05:00
//    Corresponding UTC time: 5/1/2008 11:32:00 AM

let specificDate = DateTime(2008, 5, 1, 06, 32, 00)
let offsetDate = DateTimeOffset(specificDate.Year,
                                specificDate.Month,
                                specificDate.Day,
                                specificDate.Hour,
                                specificDate.Minute,
                                specificDate.Second,
                                TimeSpan(-5, 0, 0))
printfn $"Current time: {offsetDate}"
printfn $"Corresponding UTC time: {offsetDate.UtcDateTime}"
// The code produces the following output:
//    Current time: 5/1/2008 6:32:00 AM -05:00
//    Corresponding UTC time: 5/1/2008 11:32:00 AM

   Dim specificDate As Date = #5/1/2008 6:32AM#
   Dim offsetDate As New DateTimeOffset(specificDate.Year, _
                                        specificDate.Month, _
                                        specificDate.Day, _
                                        specificDate.Hour, _
                                        specificDate.Minute, _
                                        specificDate.Second, _
                                        New TimeSpan(-5, 0, 0))
   Console.WriteLine("Current time: {0}", offsetDate)
   Console.WriteLine("Corresponding UTC time: {0}", offsetDate.UtcDateTime)                                              
' The code produces the following output:
'    Current time: 5/1/2008 6:32:00 AM -05:00
'    Corresponding UTC time: 5/1/2008 11:32:00 AM

Remarques

Ce constructeur interprète year, monthet day comme un an, un mois et un jour dans le calendrier grégorien. Pour instancier une valeur DateTimeOffset à l’aide de l’année, du mois et du jour dans un autre calendrier, appelez le constructeur DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan).

Voir aussi

instanciation d’un objet DateTimeOffset

S’applique à

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de l’année, du mois, du jour, de l’heure, de la minute, de la seconde, de la milliseconde et du décalage spécifiés.

public:
 DateTimeOffset(int year, int month, int day, int hour, int minute, int second, int millisecond, TimeSpan offset);

public DateTimeOffset (int year, int month, int day, int hour, int minute, int second, int millisecond, TimeSpan offset);

new DateTimeOffset : int * int * int * int * int * int * int * TimeSpan -> DateTimeOffset

Public Sub New (year As Integer, month As Integer, day As Integer, hour As Integer, minute As Integer, second As Integer, millisecond As Integer, offset As TimeSpan)

Paramètres

year: Int32

L’année (1 à 9999).

month: Int32

Mois (1 à 12).

day: Int32

Jour (1 au nombre de jours en month).

hour: Int32

Les heures (0 à 23).

minute: Int32

Minutes (0 à 59).

second: Int32

Secondes (0 à 59).

millisecond: Int32

Millisecondes (0 à 999).

offset: TimeSpan

Décalage de l’heure par rapport au temps universel coordonné (UTC).

Exceptions

ArgumentException

offset ne représente pas les minutes entières.

ArgumentOutOfRangeException

year est inférieur à un ou supérieur à 9999.

-ou-

month est inférieur à un ou supérieur à 12.

-ou-

day est inférieur à un ou supérieur au nombre de jours dans month.

-ou-

hour est inférieur à zéro ou supérieur à 23.

-ou-

minute est inférieur à 0 ou supérieur à 59.

-ou-

second est inférieur à 0 ou supérieur à 59.

-ou-

millisecond est inférieur à 0 ou supérieur à 999.

-ou-

offset est inférieur à -14 ou supérieur à 14.

-ou-

La propriété UtcDateTime est antérieure à DateTimeOffset.MinValue ou ultérieure à DateTimeOffset.MaxValue.

Exemples

L’exemple suivant instancie un objet DateTimeOffset à l’aide de la surcharge du constructeur DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan).

string fmt = "dd MMM yyyy HH:mm:ss";
DateTime thisDate = new DateTime(2007, 06, 12, 19, 00, 14, 16);
DateTimeOffset offsetDate = new DateTimeOffset(thisDate.Year,
                                               thisDate.Month,
                                               thisDate.Day,
                                               thisDate.Hour,
                                               thisDate.Minute,
                                               thisDate.Second,
                                               thisDate.Millisecond,
                                               new TimeSpan(2, 0, 0));
Console.WriteLine("Current time: {0}:{1}", offsetDate.ToString(fmt), offsetDate.Millisecond);
// The code produces the following output:
//    Current time: 12 Jun 2007 19:00:14:16

let fmt = "dd MMM yyyy HH:mm:ss"
let thisDate = DateTime(2007, 06, 12, 19, 00, 14, 16)
let offsetDate = DateTimeOffset(thisDate.Year,
                                thisDate.Month,
                                thisDate.Day,
                                thisDate.Hour,
                                thisDate.Minute,
                                thisDate.Second,
                                thisDate.Millisecond,
                                TimeSpan(2, 0, 0))
printfn $"Current time: {offsetDate.ToString fmt}:{offsetDate.Millisecond}"
// The code produces the following output:
//    Current time: 12 Jun 2007 19:00:14:16

Dim fmt As String = "dd MMM yyyy HH:mm:ss"
Dim thisDate As DateTime = New Date(2007, 06, 12, 19, 00, 14, 16)
Dim offsetDate As New DateTimeOffset(thisDate.Year, _
                                     thisDate.Month, _
                                     thisDate.Day, _
                                     thisDate.Hour, _
                                     thisDate.Minute, _
                                     thisDate.Second, _
                                     thisDate.Millisecond, _ 
                                     New TimeSpan(2, 0, 0))  
Console.WriteLine("Current time: {0}:{1}", offsetDate.ToString(fmt), _ 
                                           offsetDate.Millisecond)
' The code produces the following output:
'    Current time: 12 Jun 2007 19:00:14:16

Remarques

Voir aussi

instanciation d’un objet DateTimeOffset

S’applique à

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de l’année, du mois, du jour, de l’heure, de la minute, de la seconde, de la milliseconde et du décalage d’un calendrier spécifié.

public:
 DateTimeOffset(int year, int month, int day, int hour, int minute, int second, int millisecond, System::Globalization::Calendar ^ calendar, TimeSpan offset);

public DateTimeOffset (int year, int month, int day, int hour, int minute, int second, int millisecond, System.Globalization.Calendar calendar, TimeSpan offset);

new DateTimeOffset : int * int * int * int * int * int * int * System.Globalization.Calendar * TimeSpan -> DateTimeOffset

Public Sub New (year As Integer, month As Integer, day As Integer, hour As Integer, minute As Integer, second As Integer, millisecond As Integer, calendar As Calendar, offset As TimeSpan)

Paramètres

year: Int32

L’année.

month: Int32

Mois (1 à 12).

day: Int32

Jour (1 au nombre de jours en month).

hour: Int32

Les heures (0 à 23).

minute: Int32

Minutes (0 à 59).

second: Int32

Secondes (0 à 59).

millisecond: Int32

Millisecondes (0 à 999).

calendar: Calendar

Calendrier utilisé pour interpréter year, monthet day.

offset: TimeSpan

Décalage de l’heure par rapport au temps universel coordonné (UTC).

Exceptions

ArgumentException

offset ne représente pas les minutes entières.

ArgumentNullException

calendar ne peut pas être null.

ArgumentOutOfRangeException

year est inférieur à la MinSupportedDateTime.Year du paramètre calendar ou supérieur à MaxSupportedDateTime.Year.

-ou-

month est inférieur ou supérieur au nombre de mois en year dans le calendar.

-ou-

day est inférieur à un ou supérieur au nombre de jours dans month.

-ou-

hour est inférieur à zéro ou supérieur à 23.

-ou-

minute est inférieur à 0 ou supérieur à 59.

-ou-

second est inférieur à 0 ou supérieur à 59.

-ou-

millisecond est inférieur à 0 ou supérieur à 999.

-ou-

offset est inférieur à -14 heures ou supérieure à 14 heures.

-ou-

Les paramètres year, monthet day ne peuvent pas être représentés sous forme de valeur de date et d’heure.

-ou-

La propriété UtcDateTime est antérieure à DateTimeOffset.MinValue ou ultérieure à DateTimeOffset.MaxValue.

Exemples

L’exemple suivant utilise des instances de la classe HebrewCalendar et de la classe HijriCalendar pour instancier une valeur DateTimeOffset. Cette date est ensuite affichée dans la console à l’aide des calendriers respectifs et du calendrier grégorien.

CultureInfo fmt;
int year;
Calendar cal;
DateTimeOffset dateInCal;

// Instantiate DateTimeOffset with Hebrew calendar
year = 5770;
cal = new HebrewCalendar();
fmt = new CultureInfo("he-IL");
fmt.DateTimeFormat.Calendar = cal;
dateInCal = new DateTimeOffset(year, 7, 12,
                               15, 30, 0, 0,
                               cal,
                               new TimeSpan(2, 0, 0));
// Display the date in the Hebrew calendar
Console.WriteLine("Date in Hebrew Calendar: {0:g}",
                   dateInCal.ToString(fmt));
// Display the date in the Gregorian calendar
Console.WriteLine("Date in Gregorian Calendar: {0:g}", dateInCal);
Console.WriteLine();

// Instantiate DateTimeOffset with Hijri calendar
year = 1431;
cal = new HijriCalendar();
fmt = new CultureInfo("ar-SA");
fmt.DateTimeFormat.Calendar = cal;
dateInCal = new DateTimeOffset(year, 7, 12,
                               15, 30, 0, 0,
                               cal,
                               new TimeSpan(2, 0, 0));
// Display the date in the Hijri calendar
Console.WriteLine("Date in Hijri Calendar: {0:g}",
                   dateInCal.ToString(fmt));
// Display the date in the Gregorian calendar
Console.WriteLine("Date in Gregorian Calendar: {0:g}", dateInCal);
Console.WriteLine();

// Instantiate DateTimeOffset with Hebrew calendar
let year = 5770
let cal = HebrewCalendar()
let fmt = CultureInfo "he-IL"
fmt.DateTimeFormat.Calendar <- cal
let dateInCal = DateTimeOffset(year, 7, 12,
                               15, 30, 0, 0,
                               cal,
                               TimeSpan(2, 0, 0))
// Display the date in the Hebrew calendar
printfn $"Date in Hebrew Calendar: {dateInCal.ToString fmt:g}"
// Display the date in the Gregorian calendar
printfn $"Date in Gregorian Calendar: {dateInCal:g}\n"

// Instantiate DateTimeOffset with Hijri calendar
let year = 1431
let cal = HijriCalendar()
let fmt = CultureInfo "ar-SA"
fmt.DateTimeFormat.Calendar <- cal
let dateInCal = DateTimeOffset(year, 7, 12,
                               15, 30, 0, 0,
                               cal,
                               TimeSpan(2, 0, 0))
// Display the date in the Hijri calendar
printfn $"Date in Hijri Calendar: {dateInCal.ToString fmt:g}"
// Display the date in the Gregorian calendar
printfn $"Date in Gregorian Calendar: {dateInCal:g}\n"

Dim fmt As CultureInfo
Dim year As Integer
Dim cal As Calendar
Dim dateInCal As DateTimeOffset

' Instantiate DateTimeOffset with Hebrew calendar
year = 5770
cal = New HebrewCalendar()
fmt = New CultureInfo("he-IL")
fmt.DateTimeFormat.Calendar = cal      
dateInCal = New DateTimeOffset(year, 7, 12, _
                               15, 30, 0, 0, _
                               cal, _
                               New TimeSpan(2, 0, 0))
' Display the date in the Hebrew calendar
Console.WriteLine("Date in Hebrew Calendar: {0:g}", _
                   dateInCal.ToString(fmt))
' Display the date in the Gregorian calendar                         
Console.WriteLine("Date in Gregorian Calendar: {0:g}", dateInCal)
Console.WriteLine()

' Instantiate DateTimeOffset with Hijri calendar
year = 1431
cal = New HijriCalendar()
fmt = New CultureInfo("ar-SA")
fmt.DateTimeFormat.Calendar = cal
dateInCal = New DateTimeOffset(year, 7, 12, _
                               15, 30, 0, 0, _
                               cal, _
                               New TimeSpan(2, 0, 0))
' Display the date in the Hijri calendar
Console.WriteLine("Date in Hijri Calendar: {0:g}", _
                   dateInCal.ToString(fmt))
' Display the date in the Gregorian calendar                         
Console.WriteLine("Date in Gregorian Calendar: {0:g}", dateInCal)
Console.WriteLine()

Remarques

Les paramètres year, month, day, hour, minute, secondet millisecond reflètent toutes les valeurs exprimées dans le calendrier spécifié par le paramètre calendar. Une exception est levée si ces valeurs forment une date et une heure qui ne peuvent pas être exprimées à l’aide de ce calendrier.

Important

Les ères dans les calendriers japonais sont basées sur le règne de l’empereur et sont donc censées changer. Par exemple, le 1er mai 2019 marque le début de l’ère Reiwa dans les JapaneseCalendar et JapaneseLunisolarCalendar. Ce changement d’ère affecte toutes les applications qui utilisent ces calendriers. Pour plus d’informations et pour déterminer si vos applications sont affectées, consultez Gestion d’une nouvelle ère dans le calendrier japonais dans .NET. Pour plus d’informations sur le test de vos applications sur les systèmes Windows afin de garantir leur préparation au changement d’ère, consultez Préparer votre application pour la modification de l’ère japonaise. Pour les fonctionnalités de .NET qui prennent en charge les calendriers avec plusieurs ères et pour les meilleures pratiques lors de l’utilisation de calendriers qui prennent en charge plusieurs ères, consultez Utilisation des ères.

Voir aussi

instanciation d’un objet DateTimeOffset

S’applique à

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la structure DateTimeOffset à l’aide des year, month, day, hour, minute, second, millisecond, microsecond et offset.

public:
 DateTimeOffset(int year, int month, int day, int hour, int minute, int second, int millisecond, int microsecond, TimeSpan offset);

public DateTimeOffset (int year, int month, int day, int hour, int minute, int second, int millisecond, int microsecond, TimeSpan offset);

new DateTimeOffset : int * int * int * int * int * int * int * int * TimeSpan -> DateTimeOffset

Public Sub New (year As Integer, month As Integer, day As Integer, hour As Integer, minute As Integer, second As Integer, millisecond As Integer, microsecond As Integer, offset As TimeSpan)

Paramètres

year: Int32

L’année (1 à 9999).

month: Int32

Mois (1 à 12).

day: Int32

Jour (1 au nombre de jours en month).

hour: Int32

Les heures (0 à 23).

minute: Int32

Minutes (0 à 59).

second: Int32

Secondes (0 à 59).

millisecond: Int32

Millisecondes (0 à 999).

microsecond: Int32

Les microsecondes (0 à 999).

offset: TimeSpan

Décalage de l’heure par rapport au temps universel coordonné (UTC).

Exceptions

ArgumentException

offset ne représente pas les minutes entières.

ArgumentOutOfRangeException

year est inférieur à 1 ou supérieur à 9999.

-ou-

month est inférieur à 1 ou supérieur à 12.

-ou-

day est inférieur à 1 ou supérieur au nombre de jours dans month.

-ou-

hour est inférieur à 0 ou supérieur à 23.

-ou-

minute est inférieur à 0 ou supérieur à 59.

-ou-

second est inférieur à 0 ou supérieur à 59.

-ou-

millisecond est inférieur à 0 ou supérieur à 999.

-ou-

microsecond est inférieur à 0 ou supérieur à 999.

Remarques

Ce constructeur interprète year, month et day comme une année, un mois et un jour dans le calendrier grégorien. Pour instancier une valeur DateTimeOffset à l’aide de l’année, du mois et du jour dans un autre calendrier, appelez le constructeur DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan).

S’applique à

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la structure DateTimeOffset à l’aide des year, month, day, hour, minute, second, millisecond, microsecond et offset.

public:
 DateTimeOffset(int year, int month, int day, int hour, int minute, int second, int millisecond, int microsecond, System::Globalization::Calendar ^ calendar, TimeSpan offset);

public DateTimeOffset (int year, int month, int day, int hour, int minute, int second, int millisecond, int microsecond, System.Globalization.Calendar calendar, TimeSpan offset);

new DateTimeOffset : int * int * int * int * int * int * int * int * System.Globalization.Calendar * TimeSpan -> DateTimeOffset

Public Sub New (year As Integer, month As Integer, day As Integer, hour As Integer, minute As Integer, second As Integer, millisecond As Integer, microsecond As Integer, calendar As Calendar, offset As TimeSpan)

Paramètres

year: Int32

L’année (1 à 9999).

month: Int32

Mois (1 à 12).

day: Int32

Jour (1 au nombre de jours en month).

hour: Int32

Les heures (0 à 23).

minute: Int32

Minutes (0 à 59).

second: Int32

Secondes (0 à 59).

millisecond: Int32

Millisecondes (0 à 999).

microsecond: Int32

Les microsecondes (0 à 999).

calendar: Calendar

Calendrier utilisé pour interpréter year, monthet day.

offset: TimeSpan

Décalage de l’heure par rapport au temps universel coordonné (UTC).

Exceptions

ArgumentException

offset ne représente pas les minutes entières.

ArgumentOutOfRangeException

year n’est pas dans la plage prise en charge par calendar.

-ou-

month est inférieur à 1 ou supérieur au nombre de mois en calendar.

-ou-

day est inférieur à 1 ou supérieur au nombre de jours dans month.

-ou-

hour est inférieur à 0 ou supérieur à 23.

-ou-

minute est inférieur à 0 ou supérieur à 59.

-ou-

second est inférieur à 0 ou supérieur à 59.

-ou-

millisecond est inférieur à 0 ou supérieur à 999.

-ou-

microsecond est inférieur à 0 ou supérieur à 999.

-ou-

offset est inférieur à -14 heures ou supérieure à 14 heures.

-ou-

Les paramètres year, monthet day ne peuvent pas être représentés sous forme de valeur de date et d’heure.

-ou-

La propriété UtcDateTime est antérieure à MinValue ou ultérieure à MaxValue.

Remarques

S’applique à

Partager via

DateTimeOffset Constructeurs

Définition

Surcharges

DateTimeOffset(DateTime)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

DateTimeOffset(DateTime, TimeSpan)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

DateTimeOffset(Int64, TimeSpan)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Paramètres

S’applique à

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

Paramètres

Exceptions

Remarques

S’applique à

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)

Paramètres

Exceptions

Remarques

S’applique à

Ressources supplémentaires