DateTimeOffset Constructores

Referencia

Definición

Espacio de nombres:: System

Ensamblado:: System.Runtime.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicializa una nueva instancia de la estructura DateTimeOffset.

Sobrecargas

DateTimeOffset(DateTime)	Initializa una nueva instancia de la estructura DateTimeOffset mediante el valor DateTime especificado.
DateTimeOffset(DateTime, TimeSpan)	Inicializa una nueva instancia de la estructura DateTimeOffset usando el valor DateTime y el desplazamiento especificados.
DateTimeOffset(Int64, TimeSpan)	Inicializa una nueva instancia de la estructura DateTimeOffset usando el número de pasos y el desplazamiento especificados.
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Inicializa una nueva instancia de la DateTimeOffset estructura mediante el especificado `date`, `time`y `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicializa una nueva instancia de la estructura DateTimeOffset usando el año, mes, día, hora, minuto, segundo y desplazamiento especificados.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicializa una nueva instancia de la estructura DateTimeOffset con los valores de año, mes, día, hora, minuto, segundo, milisegundo y desplazamiento especificados.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Inicializa una nueva instancia de la estructura DateTimeOffset usando los valores de año, mes, día, hora, minuto, segundo, milisegundo y desplazamiento especificados de un calendario indicado.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicializa una nueva instancia de la DateTimeOffset estructura mediante el especificado `year`, , `monthhourday`, `minute`, `second`, , `millisecond`y `microsecondoffset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Inicializa una nueva instancia de la DateTimeOffset estructura mediante el especificado `year`, , `monthhourday`, `minute`, `second`, , `millisecond`y `microsecondoffset`.

DateTimeOffset(DateTime)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initializa una nueva instancia de la estructura DateTimeOffset mediante el valor DateTime especificado.

public:
 DateTimeOffset(DateTime dateTime);

public DateTimeOffset (DateTime dateTime);

new DateTimeOffset : DateTime -> DateTimeOffset

Public Sub New (dateTime As DateTime)

Parámetros

dateTime: DateTime

Fecha y hora.

Excepciones

ArgumentOutOfRangeException

La fecha y hora universal coordinada (UTC) que resulta de aplicar el desplazamiento es anterior a DateTimeOffset.MinValue.

o bien

La fecha y hora UTC que resulta de aplicar el desplazamiento es posterior a DateTimeOffset.MaxValue.

Ejemplos

En el ejemplo siguiente se muestra cómo el valor de la DateTime.Kind propiedad del parámetro afecta al valor de dateTime fecha y hora devuelto por este 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

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

Comentarios

El comportamiento de este constructor depende del valor de la DateTime.Kind propiedad del dateTime parámetro :

Si el valor de DateTime.Kind es DateTimeKind.Utc, la DateTime propiedad de la nueva instancia se establece en dateTimey la Offset propiedad se establece en Zero.
Si el valor de DateTime.Kind es DateTimeKind.Local o DateTimeKind.Unspecified, la DateTime propiedad de la nueva instancia se establece igual a dateTimey la Offset propiedad se establece igual al desplazamiento de la zona horaria actual del sistema local.

Consulte también

Creación de instancias de un objeto DateTimeOffset

Se aplica a

DateTimeOffset(DateTime, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Inicializa una nueva instancia de la estructura DateTimeOffset usando el valor DateTime y el desplazamiento especificados.

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)

Parámetros

dateTime: DateTime

Fecha y hora.

offset: TimeSpan

Desplazamiento de hora a partir de la hora universal coordinada (UTC).

Excepciones

ArgumentException

dateTime.Kind es igual a Utc y offset no es igual a cero.

o bien

dateTime.Kind es igual a Local y offset no es igual al desplazamiento de zona horaria local del sistema.

o bien

offset no está especificado en minutos enteros.

ArgumentOutOfRangeException

offset es menor que -14 horas o mayor que 14 horas.

o bien

UtcDateTime es menor que DateTimeOffset.MinValue o mayor que DateTimeOffset.MaxValue.

Ejemplos

En el ejemplo siguiente se muestra cómo inicializar un DateTimeOffset objeto con una fecha y hora y el desplazamiento de la zona horaria local cuando esa zona horaria no se conoce de antemano.

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

Comentarios

El comportamiento de este constructor depende en parte del valor de la Kind propiedad del dateTime parámetro :

Si el valor de Kind es DateTimeKind.Utc, el valor del offset parámetro debe ser 0 o se produce .ArgumentException
Si el valor de Kind es DateTimeKind.Local, el valor del offset parámetro debe ser igual al desplazamiento de la zona horaria local de la hora universal coordinada (UTC) para esa fecha concreta o se produce una ArgumentException excepción .
Si el valor de Kind es DateTimeKind.Unspecified, el offset parámetro puede tener cualquier valor válido.

Consulte también

Creación de instancias de un objeto DateTimeOffset

Se aplica a

DateTimeOffset(Int64, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Inicializa una nueva instancia de la estructura DateTimeOffset usando el número de pasos y el desplazamiento especificados.

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)

Parámetros

ticks: Int64

Fecha y hora expresadas como el número de intervalos de 100 nanosegundos transcurridos desde la medianoche (00:00:00) del 1 de enero de 0001.

offset: TimeSpan

Desplazamiento de hora a partir de la hora universal coordinada (UTC).

Excepciones

ArgumentException

offset no está especificado en minutos enteros.

ArgumentOutOfRangeException

La UtcDateTime propiedad es anterior a DateTimeOffset.MinValue o posterior a DateTimeOffset.MaxValue.

o bien

ticks es menor que DateTimeOffset.MinValue.Ticks o mayor que DateTimeOffset.MaxValue.Ticks.

o bien

Offset es menor que -14 horas o mayor que 14 horas.

Ejemplos

En el ejemplo siguiente se inicializa un DateTimeOffset objeto mediante el número de tics en una fecha arbitraria (en este caso, 16 de julio de 2007, a las 1:32 p. m.) con un desplazamiento 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

Comentarios

Normalmente, al intentar llamar al DateTimeOffset constructor para crear una instancia de un DateTimeOffset valor con una hora local y un desplazamiento distinto del de la zona horaria local, se produce una ArgumentExceptionexcepción . Puede usar esta sobrecarga del DateTimeOffset constructor para solucionar esta limitación. En el ejemplo siguiente se usa el número de tics de la hora local para crear una instancia de un DateTimeOffset valor cuyo desplazamiento no representa necesariamente el de la hora local:

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

Consulte también

Creación de instancias de un objeto DateTimeOffset

Se aplica a

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Inicializa una nueva instancia de la DateTimeOffset estructura mediante el especificado date, timey 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)

Parámetros

date: DateOnly

Parte de fecha.

time: TimeOnly

Parte de tiempo.

offset: TimeSpan

Desplazamiento de hora a partir de la hora universal coordinada (UTC).

Se aplica a

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Inicializa una nueva instancia de la estructura DateTimeOffset usando el año, mes, día, hora, minuto, segundo y desplazamiento especificados.

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)

Parámetros

year: Int32

Año (del 1 al 9999).

month: Int32

Mes (del 1 al 12).

day: Int32

Día (del 1 al número de días de month).

hour: Int32

Horas (de 0 a 23).

minute: Int32

Minutos (de 0 a 59).

second: Int32

Segundos (de 0 a 59).

offset: TimeSpan

Desplazamiento de hora a partir de la hora universal coordinada (UTC).

Excepciones

ArgumentException

offset no representa los minutos enteros.

ArgumentOutOfRangeException

year es menor que uno o mayor que 9999.

o bien

month es menor que uno o mayor que 12.

o bien

day es menor que 1 o mayor que el número de días de month.

o bien

hour es menor que cero o mayor que 23.

o bien

minute es menor que 0 o mayor que 59.

o bien

second es menor que 0 o mayor que 59.

o bien

offset es menor que -14 horas o mayor que 14 horas.

o bien

La UtcDateTime propiedad es anterior a DateTimeOffset.MinValue o posterior a DateTimeOffset.MaxValue.

Ejemplos

En el ejemplo siguiente se crea una instancia de un DateTimeOffset objeto mediante la sobrecarga del DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) constructor.

   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

Comentarios

Este constructor interpreta year, monthy day como un año, mes y día en el calendario gregoriano. Para crear una instancia de un DateTimeOffset valor mediante el año, mes y día en otro calendario, llame al DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor .

Consulte también

Creación de instancias de un objeto DateTimeOffset

Se aplica a

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Inicializa una nueva instancia de la estructura DateTimeOffset con los valores de año, mes, día, hora, minuto, segundo, milisegundo y desplazamiento especificados.

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)

Parámetros

year: Int32

Año (del 1 al 9999).

month: Int32

Mes (del 1 al 12).

day: Int32

Día (del 1 al número de días de month).

hour: Int32

Horas (de 0 a 23).

minute: Int32

Minutos (de 0 a 59).

second: Int32

Segundos (de 0 a 59).

millisecond: Int32

Milisegundos (de 0 a 999).

offset: TimeSpan

Desplazamiento de hora a partir de la hora universal coordinada (UTC).

Excepciones

ArgumentException

offset no representa los minutos enteros.

ArgumentOutOfRangeException

year es menor que uno o mayor que 9999.

o bien

month es menor que uno o mayor que 12.

o bien

day es menor que 1 o mayor que el número de días de month.

o bien

hour es menor que cero o mayor que 23.

o bien

minute es menor que 0 o mayor que 59.

o bien

second es menor que 0 o mayor que 59.

o bien

millisecond es menor que 0 o mayor que 999.

o bien

offset es menor que -14 o mayor que 14.

o bien

La UtcDateTime propiedad es anterior a DateTimeOffset.MinValue o posterior a DateTimeOffset.MaxValue.

Ejemplos

En el ejemplo siguiente se crea una instancia de un DateTimeOffset objeto mediante la sobrecarga del DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) constructor.

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

Comentarios

Este constructor interpreta year, monthy day como año, mes y día en el calendario gregoriano. Para crear una instancia de un DateTimeOffset valor mediante el año, mes y día en otro calendario, llame al DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor .

Consulte también

Creación de instancias de un objeto DateTimeOffset

Se aplica a

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Inicializa una nueva instancia de la estructura DateTimeOffset usando los valores de año, mes, día, hora, minuto, segundo, milisegundo y desplazamiento especificados de un calendario indicado.

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)

Parámetros

year: Int32

Año.

month: Int32

Mes (del 1 al 12).

day: Int32

Día (del 1 al número de días de month).

hour: Int32

Horas (de 0 a 23).

minute: Int32

Minutos (de 0 a 59).

second: Int32

Segundos (de 0 a 59).

millisecond: Int32

Milisegundos (de 0 a 999).

calendar: Calendar

Calendario que se usa para interpretar year, month y day.

offset: TimeSpan

Desplazamiento de hora a partir de la hora universal coordinada (UTC).

Excepciones

ArgumentException

offset no representa los minutos enteros.

ArgumentNullException

El valor de calendar no puede ser null.

ArgumentOutOfRangeException

year es menor que MinSupportedDateTime.Year del parámetro calendar o mayor que MaxSupportedDateTime.Year.

o bien

month es menor o mayor que el número de meses de year en el calendar.

o bien

day es menor que 1 o mayor que el número de días de month.

o bien

hour es menor que cero o mayor que 23.

o bien

minute es menor que 0 o mayor que 59.

o bien

second es menor que 0 o mayor que 59.

o bien

millisecond es menor que 0 o mayor que 999.

o bien

offset es menor que -14 horas o mayor que 14 horas.

o bien

Los parámetros year, month y day no se pueden representar como un valor de fecha y hora.

o bien

La UtcDateTime propiedad es anterior a DateTimeOffset.MinValue o posterior a DateTimeOffset.MaxValue.

Ejemplos

En el ejemplo siguiente se usan instancias de la HebrewCalendar clase y de la HijriCalendar clase para crear instancias de un DateTimeOffset valor. Después, esa fecha se muestra en la consola con los calendarios respectivos y el calendario gregoriano.

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

Comentarios

Los yearparámetros , month, dayhour, minute, second, y millisecond reflejan todos los valores expresados en el calendario especificado por el calendar parámetro . Se produce una excepción si estos valores forman una fecha y hora que no se pueden expresar mediante este calendario.

Importante

Las eras en los calendarios japoneses se basan en el reino del emperador y, por tanto, se espera que cambien. Por ejemplo, el 1 de mayo de 2019 marcaba el comienzo de la era Reiwa en JapaneseCalendar y JapaneseLunisolarCalendar. Este cambio de era afecta a todas las aplicaciones que usan estos calendarios. Para obtener más información y determinar si las aplicaciones se ven afectadas, consulte Control de una nueva era en el calendario japonés en .NET. Para obtener información sobre cómo probar las aplicaciones en sistemas Windows para garantizar su preparación para el cambio de era, consulte Preparación de la aplicación para el cambio en la era japonesa. Para conocer las características de .NET que admiten calendarios con varias eras y procedimientos recomendados al trabajar con calendarios que admiten varias eras, consulte Trabajar con eras.

Consulte también

Creación de instancias de un objeto DateTimeOffset

Se aplica a

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Inicializa una nueva instancia de la DateTimeOffset estructura mediante el especificado year, , monthhourday, minute, second, , millisecondy microsecondoffset.

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)

Parámetros

year: Int32

Año (del 1 al 9999).

month: Int32

Mes (del 1 al 12).

day: Int32

Día (del 1 al número de días de month).

hour: Int32

Horas (de 0 a 23).

minute: Int32

Minutos (de 0 a 59).

second: Int32

Segundos (de 0 a 59).

millisecond: Int32

Milisegundos (de 0 a 999).

microsecond: Int32

Microsegundos (de 0 a 999).

offset: TimeSpan

Desplazamiento de hora a partir de la hora universal coordinada (UTC).

Excepciones

ArgumentException

offset no representa los minutos enteros.

ArgumentOutOfRangeException

year es menor que 1 o mayor que 9999.

o bien

month es menor que 1 o mayor que 12.

o bien

day es menor que 1 o mayor que el número de días en month.

o bien

hour es menor que 0 o mayor que 23.

o bien

minute es menor que 0 o mayor que 59.

o bien

second es menor que 0 o mayor que 59.

o bien

millisecond es menor que 0 o mayor que 999.

o bien

microsecond es menor que 0 o mayor que 999.

Comentarios

Este constructor interpreta year, month y day como año, mes y día en el calendario gregoriano. Para crear una instancia de un DateTimeOffset valor mediante el año, mes y día en otro calendario, llame al DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor .

Se aplica a

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Inicializa una nueva instancia de la DateTimeOffset estructura mediante el especificado year, , monthhourday, minute, second, , millisecondy microsecondoffset.

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)

Parámetros

year: Int32

Año (del 1 al 9999).

month: Int32

Mes (del 1 al 12).

day: Int32

Día (del 1 al número de días de month).

hour: Int32

Horas (de 0 a 23).

minute: Int32

Minutos (de 0 a 59).

second: Int32

Segundos (de 0 a 59).

millisecond: Int32

Milisegundos (de 0 a 999).

microsecond: Int32

Microsegundos (de 0 a 999).

calendar: Calendar

Calendario que se usa para interpretar year, month y day.

offset: TimeSpan

Desplazamiento de hora a partir de la hora universal coordinada (UTC).

Excepciones

ArgumentException

offset no representa los minutos enteros.

ArgumentOutOfRangeException

year no está en el intervalo que admite calendar.

o bien

month es menor que 1 o mayor que el número de meses en calendar.

o bien

day es menor que 1 o mayor que el número de días en month.

o bien

hour es menor que 0 o mayor que 23.

o bien

minute es menor que 0 o mayor que 59.

o bien

second es menor que 0 o mayor que 59.

o bien

millisecond es menor que 0 o mayor que 999.

o bien

microsecond es menor que 0 o mayor que 999.

o bien

offset es menor que -14 horas o mayor que 14 horas.

o bien

Los parámetros year, month y day no se pueden representar como un valor de fecha y hora.

o bien

La propiedad UtcDateTime es anterior a MinValue o posterior a MaxValue.

Comentarios

Este constructor interpreta year, month y day como año, mes y día en el calendario gregoriano. Para crear una instancia de un DateTimeOffset valor mediante el año, mes y día en otro calendario, llame al DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor .

Se aplica a

DateTimeOffset Constructores

Definición

Sobrecargas

DateTimeOffset(DateTime)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

DateTimeOffset(DateTime, TimeSpan)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

DateTimeOffset(Int64, TimeSpan)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Parámetros

Se aplica a

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

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

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

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

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

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

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

Parámetros

Excepciones

Comentarios

Se aplica a

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

Parámetros

Excepciones

Comentarios

Se aplica a

Comentarios

Recursos adicionales