DateTimeOffset Constructeurs

Définition

Espace de noms:: System

Assemblys:: mscorlib.dll, System.Runtime.dll

Assemblys:: netstandard.dll, System.Runtime.dll

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 DateTimeOffset structure.

Surcharges

Nom	Description
DateTimeOffset(DateTime)	Initialise une nouvelle instance de la DateTimeOffset structure à l’aide de la valeur spécifiée DateTime .
DateTimeOffset(DateTime, TimeSpan)	Initialise une nouvelle instance de la DateTimeOffset structure à l’aide de la valeur spécifiée DateTime et `offset`.
DateTimeOffset(Int64, TimeSpan)	Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du nombre spécifié et `offsetticks` .
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du `date`, `time`et `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du `year`, , `daymonth`, , `hour`, `minute`, `second`et `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du `year`, , `daymonth`, `hour`, , `minute`, `second`, `millisecond`, et `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du `year`, , `daymonth`, `hour`, , `minute`, `second`, , `millisecondcalendar`, et `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du `year`, , `daymonth`, `hour`, , `minute`, `second`, , `millisecondmicrosecond`, et `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du `year`, , `daymonth`, , `hour`, `minute`, , `second`, `millisecond`, `microsecondcalendar`et `offset`.

DateTimeOffset(DateTime)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

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

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 DateTime.Kind propriété du dateTime paramètre 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 DateTime.Kind propriété du dateTime paramètre :

Si la valeur est DateTime.Kind DateTimeKind.Utc, la DateTime propriété de la nouvelle instance est définie sur dateTimeégale et la Offset propriété est égale à Zero.
Si la valeur est DateTime.Kind DateTimeKind.Local ou DateTimeKind.Unspecified, la DateTime propriété de la nouvelle instance est définie dateTimesur égale et la Offset propriété est égale à l’offset 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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

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

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 Utc est égal à zéro et offset n’est pas égal à zéro.

-ou-

dateTime.Kind Local est égal 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érieur à 14 heures.

-ou-

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

Exemples

L’exemple suivant montre comment initialiser un DateTimeOffset objet 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 Kind propriété du dateTime paramètre :

Si la valeur Kind est DateTimeKind.Utcdéfinie, la valeur du offset paramètre doit être 0 ou levée ArgumentException .
Si la valeur Kind est DateTimeKind.Localdéfinie, la valeur du offset paramètre doit être égale au décalage du fuseau horaire local par rapport au temps universel coordonné (UTC) de cette date particulière ou à une ArgumentException levée.
Si la valeur est Kind DateTimeKind.Unspecified, le offset paramètre 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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

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

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 UtcDateTime propriété 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érieur à 14 heures.

Exemples

L’exemple suivant initialise un DateTimeOffset objet à 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, en essayant d’appeler le DateTimeOffset constructeur pour instancier une DateTimeOffset valeur avec une heure locale et un décalage autre que celui du fuseau horaire local lève un ArgumentException. Vous pouvez utiliser cette surcharge du DateTimeOffset constructeur pour contourner cette limitation. L’exemple suivant utilise le nombre de graduations de l’heure locale pour instancier une DateTimeOffset valeur 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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du date, timeet offset.

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du year, , daymonth, , hour, minute, secondet offset.

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

Le 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 en 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érieur à 14 heures.

-ou-

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

Exemples

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

   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, mois et jour dans le calendrier grégorien. Pour instancier une DateTimeOffset valeur à l’aide de l’année, du mois et du jour dans un autre calendrier, appelez le DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructeur.

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du year, , daymonth, hour, , minute, second, millisecond, et offset.

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

Le 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 en 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 UtcDateTime propriété est antérieure à DateTimeOffset.MinValue ou ultérieure à DateTimeOffset.MaxValue.

Exemples

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

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du year, , daymonth, hour, , minute, second, , millisecondcalendar, et offset.

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

Le 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

yearest inférieur calendar ou supérieur MaxSupportedDateTime.Yearau paramètre MinSupportedDateTime.Year .

-ou-

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

-ou-

day est inférieur à un ou supérieur au nombre de jours en 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érieur à 14 heures.

-ou-

Les yearparamètres et day les monthparamètres ne peuvent pas être représentés sous forme de valeur de date et d’heure.

-ou-

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

Exemples

L’exemple suivant utilise des instances de la HebrewCalendar classe et de la HijriCalendar classe pour instancier une DateTimeOffset valeur. 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 yearparamètres , dayhourminutemonthet secondmillisecond les paramètres reflètent toutes les valeurs exprimées dans le calendrier spécifié par le calendar paramètre. 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 a marqué le début de l’ère Reiwa dans le 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 le changement d’è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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du year, , daymonth, hour, , minute, second, , millisecondmicrosecond, 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

Le 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 en 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 DateTimeOffset valeur à l’aide de l’année, du mois et du jour dans un autre calendrier, appelez le DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructeur.

S’applique à

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialise une nouvelle instance de la DateTimeOffset structure à l’aide du year, , daymonth, , hour, minute, , second, millisecond, microsecondcalendaret 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

Le 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 en 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érieur à 14 heures.

-ou-

Les yearparamètres et day les monthparamètres ne peuvent pas être représentés sous forme de valeur de date et d’heure.

-ou-

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

Remarques

S’applique à

Commentaires

Cette page a-t-elle été utile ?

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 à

Commentaires