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)	Inicializa una nueva instancia de la estructura DateTimeOffset utilizando el valor de DateTime especificado.
DateTimeOffset(DateTime, TimeSpan)	Inicializa una nueva instancia de la estructura de DateTimeOffset utilizando el valor y el desplazamiento de DateTime especificados.
DateTimeOffset(Int64, TimeSpan)	Inicializa una nueva instancia de la estructura DateTimeOffset utilizando el número especificado de tics y desplazamiento.
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Inicializa una nueva instancia de la estructura de DateTimeOffset mediante el `date`especificado, `time`y `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicializa una nueva instancia de la estructura de DateTimeOffset utilizando 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 utilizando el año, mes, día, hora, minuto, segundo, milisegundos y desplazamiento especificados.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Inicializa una nueva instancia de la estructura de DateTimeOffset utilizando el año, mes, día, hora, minuto, segundo, milisegundos y desplazamiento de un calendario especificado.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicializa una nueva instancia de la estructura de DateTimeOffset mediante el `year`especificado , `month`, `day`, `hour`, `minute`, `second`, `millisecond`, `microsecond` y `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Inicializa una nueva instancia de la estructura de DateTimeOffset mediante el `year`especificado , `month`, `day`, `hour`, `minute`, `second`, `millisecond`, `microsecond` y `offset`.

DateTimeOffset(DateTime)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Inicializa una nueva instancia de la estructura DateTimeOffset utilizando el valor de 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 coordinadas (UTC) que resulta de aplicar el desplazamiento es anterior a DateTimeOffset.MinValue.

-o-

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 propiedad DateTime.Kind del parámetro dateTime afecta al valor de 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 propiedad DateTime.Kind del parámetro dateTime:

Si el valor de DateTime.Kind es DateTimeKind.Utc, la propiedad DateTime de la nueva instancia se establece igual a dateTimey la propiedad Offset se establece igual a Zero.
Si el valor de DateTime.Kind es DateTimeKind.Local o DateTimeKind.Unspecified, la propiedad DateTime de la nueva instancia se establece igual a dateTimey la propiedad Offset 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 de DateTimeOffset utilizando el valor y el desplazamiento de DateTime 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 la hora de la hora de la hora universal coordinada (UTC).

Excepciones

ArgumentException

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

-o-

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

-o-

offset no se especifica en minutos enteros.

ArgumentOutOfRangeException

offset es menor que -14 horas o superior a 14 horas.

-o-

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

Ejemplos

En el ejemplo siguiente se muestra cómo inicializar un objeto DateTimeOffset 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 propiedad Kind del parámetro dateTime:

Si el valor de Kind es DateTimeKind.Utc, el valor del parámetro offset debe ser 0 o se produce un ArgumentException.
Si el valor de Kind es DateTimeKind.Local, el valor del parámetro offset debe ser igual al desplazamiento de la zona horaria local de la hora universal coordinada (UTC) para esa fecha concreta o se produce un ArgumentException.
Si el valor de Kind es DateTimeKind.Unspecified, el parámetro offset 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 utilizando el número especificado de tics y desplazamiento.

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 las 12:00:00 medianoche del 1 de enero de 0001.

offset: TimeSpan

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

Excepciones

ArgumentException

offset no se especifica en minutos enteros.

ArgumentOutOfRangeException

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

-o-

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

-o-

offset es menor que -14 horas o superior a 14 horas.

Ejemplos

En el ejemplo siguiente se inicializa un objeto DateTimeOffset 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 constructor de DateTimeOffset para crear una instancia de un valor de DateTimeOffset con una hora local y un desplazamiento distinto del de la zona horaria local, se produce un ArgumentException. Puede usar esta sobrecarga del constructor de DateTimeOffset para solucionar esta limitación. En el ejemplo siguiente se usa el número de tics de la hora local para crear instancias de un valor de DateTimeOffset 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 estructura de DateTimeOffset mediante el dateespecificado, 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 la hora de la hora 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 de DateTimeOffset utilizando 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

El año (de 1 a 9999).

month: Int32

Mes (de 1 a 12).

day: Int32

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

hour: Int32

Las horas (de 0 a 23).

minute: Int32

Los minutos (de 0 a 59).

second: Int32

Segundos (de 0 a 59).

offset: TimeSpan

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

Excepciones

ArgumentException

offset no representa minutos enteros.

ArgumentOutOfRangeException

year es menor que uno o mayor que 9999.

-o-

month es menor que uno o mayor que 12.

-o-

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

-o-

hour es menor que cero o mayor que 23.

-o-

minute es menor que 0 o mayor que 59.

-o-

second es menor que 0 o mayor que 59.

-o-

offset es menor que -14 horas o superior a 14 horas.

-o-

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

Ejemplos

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

   DateTime specificDate = new DateTime(2008, 5, 1, 06, 32, 00);
   DateTimeOffset offsetDate = new DateTimeOffset(specificDate.Year,
                                   specificDate.Month,
                                   specificDate.Day,
                                   specificDate.Hour,
                                   specificDate.Minute,
                                   specificDate.Second,
                                   new TimeSpan(-5, 0, 0));
   Console.WriteLine("Current time: {0}", offsetDate);
   Console.WriteLine("Corresponding UTC time: {0}", offsetDate.UtcDateTime);
// The code produces the following output:
//    Current time: 5/1/2008 6:32:00 AM -05:00
//    Corresponding UTC time: 5/1/2008 11:32:00 AM

let specificDate = DateTime(2008, 5, 1, 06, 32, 00)
let offsetDate = DateTimeOffset(specificDate.Year,
                                specificDate.Month,
                                specificDate.Day,
                                specificDate.Hour,
                                specificDate.Minute,
                                specificDate.Second,
                                TimeSpan(-5, 0, 0))
printfn $"Current time: {offsetDate}"
printfn $"Corresponding UTC time: {offsetDate.UtcDateTime}"
// The code produces the following output:
//    Current time: 5/1/2008 6:32:00 AM -05:00
//    Corresponding UTC time: 5/1/2008 11:32:00 AM

   Dim specificDate As Date = #5/1/2008 6:32AM#
   Dim offsetDate As New DateTimeOffset(specificDate.Year, _
                                        specificDate.Month, _
                                        specificDate.Day, _
                                        specificDate.Hour, _
                                        specificDate.Minute, _
                                        specificDate.Second, _
                                        New TimeSpan(-5, 0, 0))
   Console.WriteLine("Current time: {0}", offsetDate)
   Console.WriteLine("Corresponding UTC time: {0}", offsetDate.UtcDateTime)                                              
' The code produces the following output:
'    Current time: 5/1/2008 6:32:00 AM -05:00
'    Corresponding UTC time: 5/1/2008 11:32:00 AM

Comentarios

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

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 utilizando el año, mes, día, hora, minuto, segundo, milisegundos 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

El año (de 1 a 9999).

month: Int32

Mes (de 1 a 12).

day: Int32

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

hour: Int32

Las horas (de 0 a 23).

minute: Int32

Los minutos (de 0 a 59).

second: Int32

Segundos (de 0 a 59).

millisecond: Int32

Milisegundos (de 0 a 999).

offset: TimeSpan

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

Excepciones

ArgumentException

offset no representa minutos enteros.

ArgumentOutOfRangeException

year es menor que uno o mayor que 9999.

-o-

month es menor que uno o mayor que 12.

-o-

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

-o-

hour es menor que cero o mayor que 23.

-o-

minute es menor que 0 o mayor que 59.

-o-

second es menor que 0 o mayor que 59.

-o-

millisecond es menor que 0 o mayor que 999.

-o-

offset es menor que -14 o mayor que 14.

-o-

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

Ejemplos

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

string fmt = "dd MMM yyyy HH:mm:ss";
DateTime thisDate = new DateTime(2007, 06, 12, 19, 00, 14, 16);
DateTimeOffset offsetDate = new DateTimeOffset(thisDate.Year,
                                               thisDate.Month,
                                               thisDate.Day,
                                               thisDate.Hour,
                                               thisDate.Minute,
                                               thisDate.Second,
                                               thisDate.Millisecond,
                                               new TimeSpan(2, 0, 0));
Console.WriteLine("Current time: {0}:{1}", offsetDate.ToString(fmt), offsetDate.Millisecond);
// The code produces the following output:
//    Current time: 12 Jun 2007 19:00:14:16

let fmt = "dd MMM yyyy HH:mm:ss"
let thisDate = DateTime(2007, 06, 12, 19, 00, 14, 16)
let offsetDate = DateTimeOffset(thisDate.Year,
                                thisDate.Month,
                                thisDate.Day,
                                thisDate.Hour,
                                thisDate.Minute,
                                thisDate.Second,
                                thisDate.Millisecond,
                                TimeSpan(2, 0, 0))
printfn $"Current time: {offsetDate.ToString fmt}:{offsetDate.Millisecond}"
// The code produces the following output:
//    Current time: 12 Jun 2007 19:00:14:16

Dim fmt As String = "dd MMM yyyy HH:mm:ss"
Dim thisDate As DateTime = New Date(2007, 06, 12, 19, 00, 14, 16)
Dim offsetDate As New DateTimeOffset(thisDate.Year, _
                                     thisDate.Month, _
                                     thisDate.Day, _
                                     thisDate.Hour, _
                                     thisDate.Minute, _
                                     thisDate.Second, _
                                     thisDate.Millisecond, _ 
                                     New TimeSpan(2, 0, 0))  
Console.WriteLine("Current time: {0}:{1}", offsetDate.ToString(fmt), _ 
                                           offsetDate.Millisecond)
' The code produces the following output:
'    Current time: 12 Jun 2007 19:00:14:16

Comentarios

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 de DateTimeOffset utilizando el año, mes, día, hora, minuto, segundo, milisegundos y desplazamiento de un calendario especificado.

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

El año.

month: Int32

Mes (de 1 a 12).

day: Int32

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

hour: Int32

Las horas (de 0 a 23).

minute: Int32

Los 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, monthy day.

offset: TimeSpan

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

Excepciones

ArgumentException

offset no representa minutos enteros.

ArgumentNullException

calendar no se puede null.

ArgumentOutOfRangeException

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

-o-

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

-o-

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

-o-

hour es menor que cero o mayor que 23.

-o-

minute es menor que 0 o mayor que 59.

-o-

second es menor que 0 o mayor que 59.

-o-

millisecond es menor que 0 o mayor que 999.

-o-

offset es menor que -14 horas o superior a 14 horas.

-o-

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

-o-

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

Ejemplos

En el ejemplo siguiente se usan instancias de la clase HebrewCalendar y la clase HijriCalendar para crear instancias de un valor de DateTimeOffset. Esa fecha se muestra a continuación en la consola mediante 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 parámetros year, month, day, hour, minute, secondy millisecond reflejan todos los valores expresados en el calendario especificado por el parámetro calendar. 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 reinado del emperador y, por tanto, se espera que cambien. Por ejemplo, el 1 de mayo de 2019 marcó el comienzo de la era Reiwa en el 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 Preparar la aplicación para el cambio de la era japonesa. Para ver las características de .NET que admiten calendarios con varias eras y para obtener procedimientos recomendados al trabajar con calendarios que admiten varias eras, consulte Working with 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 estructura de DateTimeOffset mediante el yearespecificado , month, day, hour, minute, second, millisecond, microsecond y 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)

Parámetros

year: Int32

El año (de 1 a 9999).

month: Int32

Mes (de 1 a 12).

day: Int32

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

hour: Int32

Las horas (de 0 a 23).

minute: Int32

Los 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 la hora de la hora de la hora universal coordinada (UTC).

Excepciones

ArgumentException

offset no representa minutos enteros.

ArgumentOutOfRangeException

year es menor que 1 o mayor que 9999.

-o-

month es menor que 1 o mayor que 12.

-o-

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

-o-

hour es menor que 0 o mayor que 23.

-o-

minute es menor que 0 o mayor que 59.

-o-

second es menor que 0 o mayor que 59.

-o-

millisecond es menor que 0 o mayor que 999.

-o-

microsecond es menor que 0 o mayor que 999.

Comentarios

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

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 estructura de DateTimeOffset mediante el yearespecificado , month, day, hour, minute, second, millisecond, microsecond y 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)

Parámetros

year: Int32

El año (de 1 a 9999).

month: Int32

Mes (de 1 a 12).

day: Int32

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

hour: Int32

Las horas (de 0 a 23).

minute: Int32

Los 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, monthy day.

offset: TimeSpan

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

Excepciones

ArgumentException

offset no representa minutos enteros.

ArgumentOutOfRangeException

year no está en el intervalo admitido por calendar.

-o-

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

-o-

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

-o-

hour es menor que 0 o mayor que 23.

-o-

minute es menor que 0 o mayor que 59.

-o-

second es menor que 0 o mayor que 59.

-o-

millisecond es menor que 0 o mayor que 999.

-o-

microsecond es menor que 0 o mayor que 999.

-o-

offset es menor que -14 horas o superior a 14 horas.

-o-

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

-o-

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

Comentarios

Se aplica a

Comparteix a través de

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

Recursos addicionals