DateTimeOffset Constructeurs

Définition

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, timeet offsetspé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

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 :

Voir aussi

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

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.

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 :

Voir aussi

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

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

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

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

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

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

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

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

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

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

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

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

calendar ne peut pas être null.

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

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

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

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

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

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

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 à