DateTimeOffset Costruttori

Definizione

Inizializza una nuova istanza della struttura DateTimeOffset.Initializes a new instance of the DateTimeOffset structure.

Overload

DateTimeOffset(DateTime)

Inizializza una nuova istanza della struttura DateTimeOffset usando il valore DateTime specificato.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value.

DateTimeOffset(DateTime, TimeSpan)

Inizializza una nuova istanza della struttura DateTimeOffset usando il valore e l'offset della struttura DateTime specificati.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value and offset.

DateTimeOffset(Int64, TimeSpan)

Inizializza una nuova istanza della struttura DateTimeOffset usando il numero di tick e l'offset specificati.Initializes a new instance of the DateTimeOffset structure using the specified number of ticks and offset.

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

Inizializza una nuova istanza della struttura DateTimeOffset usando l'anno, il mese, il giorno, l'ora, il minuto, il secondo e l'offset specificati.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, and offset.

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

Inizializza una nuova istanza della struttura DateTimeOffset usando l'anno, il mese, il giorno, l'ora, il minuto, il secondo, il millisecondo e l'offset specificati.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset.

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

Inizializza una nuova istanza della struttura DateTimeOffset usando l'anno, il mese, il giorno, l'ora, il minuto, il secondo, il millisecondo e l'offset specificati di un determinato calendario.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset of a specified calendar.

DateTimeOffset(DateTime)

Inizializza una nuova istanza della struttura DateTimeOffset usando il valore DateTime specificato.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value.

public:
 DateTimeOffset(DateTime dateTime);
public DateTimeOffset (DateTime dateTime);
new DateTimeOffset : DateTime -> DateTimeOffset

Parametri

dateTime
DateTime

Data e ora.A date and time.

Eccezioni

La data e l'ora UTC (Coordinated Universal Time) risultanti dall'applicazione dell'offset sono precedenti a MinValue.The Coordinated Universal Time (UTC) date and time that results from applying the offset is earlier than MinValue.

-oppure--or- La data e l'ora UTC risultanti dall'applicazione dell'offset sono successive a MaxValue.The UTC date and time that results from applying the offset is later than MaxValue.

Esempi

Nell'esempio seguente viene illustrato il modo in cui il DateTime.Kind valore della proprietà dateTime del parametro influiscono sul valore di data e ora restituito da questo costruttore.The following example illustrates how the value of the DateTime.Kind property of the dateTime parameter affects the date and time value that is returned by this constructor.

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      
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      

Commenti

Il comportamento di questo costruttore dipende dal valore della DateTime.Kind proprietà dateTime del parametro:This constructor's behavior depends on the value of the DateTime.Kind property of the dateTime parameter:

Vedi anche

DateTimeOffset(DateTime, TimeSpan)

Inizializza una nuova istanza della struttura DateTimeOffset usando il valore e l'offset della struttura DateTime specificati.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value and offset.

public:
 DateTimeOffset(DateTime dateTime, TimeSpan offset);
public DateTimeOffset (DateTime dateTime, TimeSpan offset);
new DateTimeOffset : DateTime * TimeSpan -> DateTimeOffset

Parametri

dateTime
DateTime

Data e ora.A date and time.

offset
TimeSpan

Offset dell'ora rispetto all'ora UTC (Coordinated Universal Time).The time's offset from Coordinated Universal Time (UTC).

Eccezioni

dateTime.Kind è uguale a Utc e offset non è uguale a zero.dateTime.Kind equals Utc and offset does not equal zero.

In alternativa-or- dateTime.Kind è uguale a Local e offset non è uguale all'offset del fuso orario locale del sistema.dateTime.Kind equals Local and offset does not equal the offset of the system's local time zone.

In alternativa-or- offset non è specificato in minuti interi.offset is not specified in whole minutes.

offset è minore di -14 ore o maggiore di 14 ore.offset is less than -14 hours or greater than 14 hours.

-oppure--or- UtcDateTime è minore di MinValue o maggiore di MaxValue.UtcDateTime is less than MinValue or greater than MaxValue.

Esempi

Nell'esempio seguente viene illustrato come inizializzare DateTimeOffset un oggetto con una data e un'ora e l'offset del fuso orario locale quando tale fuso orario non è noto in anticipo.The following example shows how to initialize a DateTimeOffset object with a date and time and the offset of the local time zone when that time zone is not known in advance.

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
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

Commenti

Il comportamento di questo costruttore dipende in parte dal valore della Kind proprietà dateTime del parametro:This constructor's behavior depends in part on the value of the Kind property of the dateTime parameter:

Vedi anche

DateTimeOffset(Int64, TimeSpan)

Inizializza una nuova istanza della struttura DateTimeOffset usando il numero di tick e l'offset specificati.Initializes a new instance of the DateTimeOffset structure using the specified number of ticks and offset.

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)

Parametri

ticks
Int64

Data e ora espresse come numero di intervalli da 100 nanosecondi trascorsi dalle ore 12.00.00, mezzanotte del 1 gennaio 0001.A date and time expressed as the number of 100-nanosecond intervals that have elapsed since 12:00:00 midnight on January 1, 0001.

offset
TimeSpan

Offset dell'ora rispetto all'ora UTC (Coordinated Universal Time).The time's offset from Coordinated Universal Time (UTC).

Eccezioni

offset non è specificato in minuti interi.offset is not specified in whole minutes.

La proprietà UtcDateTime è precedente a MinValue o successiva a MaxValue.The UtcDateTime property is earlier than MinValue or later than MaxValue.

-oppure--or- ticks è minore di DateTimeOffset.MinValue.Ticks o maggiore di DateTimeOffset.MaxValue.Ticks.ticks is less than DateTimeOffset.MinValue.Ticks or greater than DateTimeOffset.MaxValue.Ticks.

-oppure--or- Offset è minore di -14 ore o maggiore di 14 ore.Offset s less than -14 hours or greater than 14 hours.

Esempi

Nell'esempio seguente viene inizializzato un DateTimeOffset oggetto utilizzando il numero di cicli in una data arbitraria (in questo caso, il 16 luglio 2007, alle 1:32 PM) con un offset pari a-5.The following example initializes a DateTimeOffset object by using the number of ticks in an arbitrary date (in this case, July 16, 2007, at 1:32 PM) with an offset of -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
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

Commenti

In genere, il tentativo di chiamare DateTimeOffset il costruttore per creare un' DateTimeOffset istanza di un valore con un'ora locale e un offset diverso da quello del fuso orario locale ArgumentExceptiongenera un'eccezione.Ordinarily, trying to call the DateTimeOffset constructor to instantiate a DateTimeOffset value with a local time and an offset other than that of the local time zone throws an ArgumentException. È possibile utilizzare questo overload del DateTimeOffset costruttore per ovviare a questa limitazione.You can use this overload of the DateTimeOffset constructor to work around this limitation. Nell'esempio seguente viene usato il numero di cicli dell'ora locale per creare un'istanza DateTimeOffset di un valore il cui offset non rappresenta necessariamente quello dell'ora locale:The following example uses the local time's number of ticks to instantiate a DateTimeOffset value whose offset does not necessarily represent that of the local time:

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
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

Vedi anche

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

Inizializza una nuova istanza della struttura DateTimeOffset usando l'anno, il mese, il giorno, l'ora, il minuto, il secondo e l'offset specificati.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, and 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)

Parametri

year
Int32

Anno (da 1 a 9999).The year (1 through 9999).

month
Int32

Mese (da 1 a 12).The month (1 through 12).

day
Int32

Giorno (da 1 al numero di giorni in month).The day (1 through the number of days in month).

hour
Int32

Ore (da 0 a 23).The hours (0 through 23).

minute
Int32

Minuti (da 0 a 59).The minutes (0 through 59).

second
Int32

Secondi (da 0 a 59).The seconds (0 through 59).

offset
TimeSpan

Offset dell'ora rispetto all'ora UTC (Coordinated Universal Time).The time's offset from Coordinated Universal Time (UTC).

Eccezioni

offset non rappresenta minuti interi.offset does not represent whole minutes.

year è minore di 1 o maggiore di 9999.year is less than one or greater than 9999.

-oppure--or- month è minore di 1 o maggiore di 12.month is less than one or greater than 12.

-oppure--or- day è minore di 1 o maggiore del numero di giorni in month.day is less than one or greater than the number of days in month.

-oppure--or- hour è minore di zero o maggiore di 23.hour is less than zero or greater than 23.

In alternativa-or- minute è minore di 0 o maggiore di 59.minute is less than 0 or greater than 59.

-oppure--or- second è minore di 0 o maggiore di 59.second is less than 0 or greater than 59.

-oppure--or- offset è minore di -14 ore o maggiore di 14 ore.offset is less than -14 hours or greater than 14 hours.

-oppure--or- La proprietà UtcDateTime è precedente a MinValue o successiva a MaxValue.The UtcDateTime property is earlier than MinValue or later than MaxValue.

Esempi

Nell'esempio seguente viene creata un' DateTimeOffset istanza di un oggetto DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) utilizzando l'overload del costruttore.The following example instantiates a DateTimeOffset object by using the DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) constructor overload.

   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      
   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      

Commenti

Questo costruttore interpreta year, monthe day come anno, mese e giorno nel calendario gregoriano.This constructor interprets year, month, and day as a year, month, and day in the Gregorian calendar. Per creare un'istanza DateTimeOffset di un valore usando l'anno, il mese e il giorno in un altro calendario DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) , chiamare il costruttore.To instantiate a DateTimeOffset value by using the year, month, and day in another calendar, call the DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor.

Vedi anche

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

Inizializza una nuova istanza della struttura DateTimeOffset usando l'anno, il mese, il giorno, l'ora, il minuto, il secondo, il millisecondo e l'offset specificati.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and 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)

Parametri

year
Int32

Anno (da 1 a 9999).The year (1 through 9999).

month
Int32

Mese (da 1 a 12).The month (1 through 12).

day
Int32

Giorno (da 1 al numero di giorni in month).The day (1 through the number of days in month).

hour
Int32

Ore (da 0 a 23).The hours (0 through 23).

minute
Int32

Minuti (da 0 a 59).The minutes (0 through 59).

second
Int32

Secondi (da 0 a 59).The seconds (0 through 59).

millisecond
Int32

Millisecondi (da 0 a 999).The milliseconds (0 through 999).

offset
TimeSpan

Offset dell'ora rispetto all'ora UTC (Coordinated Universal Time).The time's offset from Coordinated Universal Time (UTC).

Eccezioni

offset non rappresenta minuti interi.offset does not represent whole minutes.

year è minore di 1 o maggiore di 9999.year is less than one or greater than 9999.

-oppure--or- month è minore di 1 o maggiore di 12.month is less than one or greater than 12.

In alternativa-or- day è minore di 1 o maggiore del numero di giorni in month.day is less than one or greater than the number of days in month.

-oppure--or- hour è minore di zero o maggiore di 23.hour is less than zero or greater than 23.

In alternativa-or- minute è minore di 0 o maggiore di 59.minute is less than 0 or greater than 59.

-oppure--or- second è minore di 0 o maggiore di 59.second is less than 0 or greater than 59.

In alternativa-or- millisecond è minore di 0 o maggiore di 999.millisecond is less than 0 or greater than 999.

In alternativa-or- offset è minore di -14 o maggiore di 14.offset is less than -14 or greater than 14.

In alternativa-or- La proprietà UtcDateTime è precedente a MinValue o successiva a MaxValue.The UtcDateTime property is earlier than MinValue or later than MaxValue.

Esempi

Nell'esempio seguente viene creata un' DateTimeOffset istanza di un oggetto DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) utilizzando l'overload del costruttore.The following example instantiates a DateTimeOffset object by using the DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) constructor overload.

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      
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      

Commenti

Questo costruttore interpreta year, monthe day come anno, mese e giorno nel calendario gregoriano.This constructor interprets year, month, and day as a year, month, and day in the Gregorian calendar. Per creare un'istanza DateTimeOffset di un valore usando l'anno, il mese e il giorno in un altro calendario DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) , chiamare il costruttore.To instantiate a DateTimeOffset value by using the year, month, and day in another calendar, call the DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor.

Vedi anche

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

Inizializza una nuova istanza della struttura DateTimeOffset usando l'anno, il mese, il giorno, l'ora, il minuto, il secondo, il millisecondo e l'offset specificati di un determinato calendario.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset of a specified calendar.

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

Parametri

year
Int32

Anno.The year.

month
Int32

Mese (da 1 a 12).The month (1 through 12).

day
Int32

Giorno (da 1 al numero di giorni in month).The day (1 through the number of days in month).

hour
Int32

Ore (da 0 a 23).The hours (0 through 23).

minute
Int32

Minuti (da 0 a 59).The minutes (0 through 59).

second
Int32

Secondi (da 0 a 59).The seconds (0 through 59).

millisecond
Int32

Millisecondi (da 0 a 999).The milliseconds (0 through 999).

calendar
Calendar

Calendario usato per interpretare year, month e day.The calendar that is used to interpret year, month, and day.

offset
TimeSpan

Offset dell'ora rispetto all'ora UTC (Coordinated Universal Time).The time's offset from Coordinated Universal Time (UTC).

Eccezioni

offset non rappresenta minuti interi.offset does not represent whole minutes.

Il parametro calendar non può essere null.calendar cannot be null.

year è minore dell'oggetto calendar del parametro MinSupportedDateTime.Year o maggiore di MaxSupportedDateTime.Year.year is less than the calendar parameter's MinSupportedDateTime.Year or greater than MaxSupportedDateTime.Year.

In alternativa-or- month è minore o maggiore del numero di mesi in year nell'oggetto calendar.month is either less than or greater than the number of months in year in the calendar.

-oppure--or- day è minore di 1 o maggiore del numero di giorni in month.day is less than one or greater than the number of days in month.

-oppure--or- hour è minore di zero o maggiore di 23.hour is less than zero or greater than 23.

In alternativa-or- minute è minore di 0 o maggiore di 59.minute is less than 0 or greater than 59.

-oppure--or- second è minore di 0 o maggiore di 59.second is less than 0 or greater than 59.

-oppure--or- millisecond è minore di 0 o maggiore di 999.millisecond is less than 0 or greater than 999.

-oppure--or- offset è minore di -14 ore o maggiore di 14 ore.offset is less than -14 hours or greater than 14 hours.

In alternativa-or- I parametri year, month e day non possono essere rappresentati come valore di data e ora.The year, month, and day parameters cannot be represented as a date and time value.

-oppure--or- La proprietà UtcDateTime è precedente a MinValue o successiva a MaxValue.The UtcDateTime property is earlier than MinValue or later than MaxValue.

Esempi

Nell'esempio seguente vengono utilizzate le istanze della HebrewCalendar classe e della HijriCalendar classe per creare un'istanza DateTimeOffset di un valore.The following example uses instances of both the HebrewCalendar class and the HijriCalendar class to instantiate a DateTimeOffset value. Tale data viene quindi visualizzata alla console utilizzando i rispettivi calendari e il calendario gregoriano.That date is then displayed to the console using the respective calendars and the Gregorian calendar.

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();
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()

Commenti

I yearparametri month,, day, ,minute,e riflettono tutti i valori espressi nel calendario specificato dal parametro.calendar millisecond second hourThe year, month, day, hour, minute, second, and millisecond parameters all reflect values expressed in the calendar specified by the calendar parameter. Viene generata un'eccezione se questi valori formano una data e un'ora che non possono essere espresse utilizzando questo calendario.An exception is thrown if these values form a date and time that cannot be expressed by using this calendar.

Importante

Le ere nel calendario giapponese sono basate sul regno dell'imperatore e pertanto è previsto che cambino.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Ad esempio, il 1° maggio 2019 contraddistingue l'inizio dell'era Reiwa in JapaneseCalendar e JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Questo cambio di era interessa tutte le applicazioni che usano questi calendari.Such a change of era affects all applications that use these calendars. Vedere Handling a new era in the Japanese calendar in .NET (Gestione di una nuova era nel calendario giapponese in .NET) per altre informazioni e per determinare se le proprie applicazioni sono interessate dal cambio.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Vedere Prepare your application for the Japanese era change (Preparare l'applicazione per il cambio di era giapponese) per informazioni sul test delle applicazioni nei sistemi Windows per verificare che siano pronte per il cambio di era.See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. Vedere Utilizzo delle ere per informazioni sulle funzionalità in .NET che supportano calendari con più ere e per le procedure consigliate per l'uso dei calendari che supportano più ere.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

Vedi anche

Si applica a