DateTimeOffset Constructeurs
Définition
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 en utilisant la valeur DateTime spécifiée. |
DateTimeOffset(DateTime, TimeSpan) |
Initialise une nouvelle instance de la structure DateTimeOffset en utilisant la valeur DateTime et le décalage spécifiés. |
DateTimeOffset(Int64, TimeSpan) |
Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de l’offset et du nombre de graduations spécifiés. |
DateTimeOffset(DateOnly, TimeOnly, TimeSpan) |
Initialise une nouvelle instance de la structure à l’aide DateTimeOffset des spécifiés |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Initialise une nouvelle instance de la structure DateTimeOffset en utilisant l’année, le mois, le jour, l’heure, la minute, la seconde et le décalage spécifiés. |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Initialise une nouvelle instance de la structure DateTimeOffset en utilisant l’année, le mois, le jour, l’heure, la minute, la seconde, la milliseconde et le décalage spécifiés. |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Initialise une nouvelle instance de la structure DateTimeOffset en utilisant l’année, le mois, le jour, l’heure, la minute, la seconde, la milliseconde et le décalage (offset) spécifiés pour un calendrier spécifié. |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Initialise une nouvelle instance de la structure à l’aide DateTimeOffset des spécifiés |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Initialise une nouvelle instance de la structure à l’aide DateTimeOffset des spécifiés |
DateTimeOffset(DateTime)
- Source:
- DateTimeOffset.cs
- Source:
- DateTimeOffset.cs
- Source:
- DateTimeOffset.cs
Initialise une nouvelle instance de la structure DateTimeOffset en utilisant 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 (Coordinated Universal Time) qui résultent de l’application du décalage sont antérieures à DateTimeOffset.MinValue.
-ou-
La date et l’heure UTC qui résultent de l’application du décalage sont postérieures à DateTimeOffset.MaxValue.
Exemples
L’exemple suivant montre comment la valeur de la DateTime.Kind propriété du paramètre affecte la dateTime
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 de DateTime.Kind est DateTimeKind.Utc, la DateTime propriété du nouveau instance est définie sur
dateTime
, et la Offset propriété est définie sur Zero.Si la valeur de DateTime.Kind est DateTimeKind.Local ou DateTimeKind.Unspecified, la DateTime propriété du nouveau instance est définie sur
dateTime
, et la Offset propriété est égale au décalage du fuseau horaire actuel du système local.
Voir aussi
S’applique à
DateTimeOffset(DateTime, TimeSpan)
- Source:
- DateTimeOffset.cs
- Source:
- DateTimeOffset.cs
- Source:
- DateTimeOffset.cs
Initialise une nouvelle instance de la structure DateTimeOffset en utilisant la valeur DateTime et le décalage 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 d'heure à partir du temps universel.
Exceptions
dateTime.Kind
a la valeur Utc et offset
est différent de zéro.
- ou -
dateTime.Kind
est égal à Local et offset
est différent du décalage du fuseau horaire local du système.
- ou -
offset
n’est pas spécifié en minutes entières.
La valeur de offset
est inférieure à -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 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 de Kind est DateTimeKind.Utc, la valeur du
offset
paramètre doit être 0 ou un ArgumentException est levée.Si la valeur de Kind est DateTimeKind.Local, la valeur du
offset
paramètre doit être égale au décalage du fuseau horaire local par rapport au temps universel coordonné (UTC) pour cette date particulière ou un ArgumentException est levée.Si la valeur de Kind est DateTimeKind.Unspecified, le
offset
paramètre peut avoir n’importe quelle valeur valide.
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 de l’offset et du nombre de graduations spécifiés.
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 d'un nombre d'intervalles de 100 nanosecondes écoulés depuis le 1er janvier 0001, à 12:00:00 (minuit).
- offset
- TimeSpan
Décalage d'heure à partir du temps universel.
Exceptions
offset
n’est pas spécifié en minutes entières.
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 -
La valeur de Offset
est inférieure à-14 heures ou supérieure à 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, à 13h32) 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, essayer 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
S’applique à
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)
- Source:
- DateTimeOffset.cs
- Source:
- DateTimeOffset.cs
Initialise une nouvelle instance de la structure à l’aide DateTimeOffset des spécifiés date
, time
et 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 date.
- time
- TimeOnly
Partie de temps.
- offset
- TimeSpan
Décalage d'heure à partir du temps universel.
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 en utilisant l’année, le mois, le jour, l’heure, la minute, la seconde et le 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
Année (1 à 9999).
- month
- Int32
Mois (1 à 12).
- day
- Int32
Jour (de 1 au nombre de jours de month
).
- hour
- Int32
Heures (0 à 23).
- minute
- Int32
Minutes (0 à 59).
- second
- Int32
Secondes (0 à 59).
- offset
- TimeSpan
Décalage d'heure à partir du temps universel.
Exceptions
offset
ne représente pas des minutes entières.
year
est inférieur à 1 ou supérieur à 9 999.
- ou -
month
est inférieur à 1 ou supérieur à 12.
- ou -
La valeur de day
est inférieure à un ou supérieure au nombre de jours indiqué 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 -
La valeur de offset
est inférieure à -14 heures ou supérieure à 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
, 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 d’un autre calendrier, appelez le DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructeur.
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 en utilisant l’année, le mois, le jour, l’heure, la minute, la seconde, la milliseconde et le 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
Année (1 à 9999).
- month
- Int32
Mois (1 à 12).
- day
- Int32
Jour (de 1 au nombre de jours de month
).
- hour
- Int32
Heures (0 à 23).
- minute
- Int32
Minutes (0 à 59).
- second
- Int32
Secondes (0 à 59).
- millisecond
- Int32
Millisecondes (0 à 999).
- offset
- TimeSpan
Décalage d'heure à partir du temps universel.
Exceptions
offset
ne représente pas des minutes entières.
year
est inférieur à 1 ou supérieur à 9 999.
- ou -
month
est inférieur à 1 ou supérieur à 12.
- ou -
La valeur de day
est inférieure à un ou supérieure au nombre de jours indiqué 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 -
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
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 d’un autre calendrier, appelez le DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructeur.
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 en utilisant l’année, le mois, le jour, l’heure, la minute, la seconde, la milliseconde et le décalage (offset) spécifiés pour 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
Année.
- month
- Int32
Mois (1 à 12).
- day
- Int32
Jour (de 1 au nombre de jours de month
).
- hour
- Int32
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
, month
et day
.
- offset
- TimeSpan
Décalage d'heure à partir du temps universel.
Exceptions
offset
ne représente pas des minutes entières.
calendar
ne peut pas avoir la valeur null
.
La valeur de year
est inférieure à la valeur de MinSupportedDateTime.Year
du paramètre calendar
ou supérieure à la valeur de MaxSupportedDateTime.Year
.
- ou -
La valeur de month
est inférieure ou supérieure au nombre de mois indiqué dans le paramètre year
de calendar
.
- ou -
La valeur de day
est inférieure à un ou supérieure au nombre de jours indiqué 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 -
La valeur de offset
est inférieure à -14 heures ou supérieure à 14 heures.
- ou -
Les paramètres year
, month
et day
ne peuvent pas être représentés par une 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 year
paramètres , month
, hour
day
, minute
, second
, et millisecond
reflètent tous 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 des calendriers japonais sont basées sur le règne de l’empereur et sont donc amenées à changer. Par exemple, le 1 mai 2019 a marqué le début de l’ère Reiwa dans 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 connaître les fonctionnalités de .NET qui prennent en charge les calendriers avec plusieurs ères et pour connaître 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 à l’aide DateTimeOffset des spécifiés year
, , month
, day
, minute
hour
, second
, , microsecond
millisecond
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
Année (1 à 9999).
- month
- Int32
Mois (1 à 12).
- day
- Int32
Jour (de 1 au nombre de jours de month
).
- hour
- Int32
Heures (0 à 23).
- minute
- Int32
Minutes (0 à 59).
- second
- Int32
Secondes (0 à 59).
- millisecond
- Int32
Millisecondes (0 à 999).
- microsecond
- Int32
Microsecondes (0 à 999).
- offset
- TimeSpan
Décalage d'heure à partir du temps universel.
Exceptions
offset
ne représente pas des minutes entières.
year
est inférieur à 1 ou supérieur à 9 999.
- 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 DateTimeOffset valeur à l’aide de l’année, du mois et du jour d’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
Initialise une nouvelle instance de la structure à l’aide DateTimeOffset des spécifiés year
, , day
month
, 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
Année (1 à 9999).
- month
- Int32
Mois (1 à 12).
- day
- Int32
Jour (de 1 au nombre de jours de month
).
- hour
- Int32
Heures (0 à 23).
- minute
- Int32
Minutes (0 à 59).
- second
- Int32
Secondes (0 à 59).
- millisecond
- Int32
Millisecondes (0 à 999).
- microsecond
- Int32
Microsecondes (0 à 999).
- calendar
- Calendar
Calendrier utilisé pour interpréter year
, month
et day
.
- offset
- TimeSpan
Décalage d'heure à partir du temps universel.
Exceptions
offset
ne représente pas des minutes entières.
year
n’appartient pas à la plage prise en charge par calendar
.
- ou -
month
est inférieur à 1 ou supérieur au nombre de mois dans 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 -
La valeur de offset
est inférieure à -14 heures ou supérieure à 14 heures.
- ou -
Les paramètres year
, month
et day
ne peuvent pas être représentés par une valeur de date et d’heure.
- ou -
La propriété UtcDateTime est antérieure à MinValue ou posté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 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 à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour