DateTimeOffset Constructores
Definición
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 |
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 |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Inicializa una nueva instancia de la DateTimeOffset estructura mediante el especificado |
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
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
dateTime
y 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
dateTime
y la Offset propiedad se establece igual al desplazamiento de la zona horaria actual del sistema local.
Consulte también
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
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.
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 .ArgumentExceptionSi 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
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
offset
no está especificado en minutos enteros.
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
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
, time
y 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
offset
no representa los minutos enteros.
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
, month
y 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
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
offset
no representa los minutos enteros.
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
, 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, Calendar, TimeSpan) constructor .
Consulte también
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
offset
no representa los minutos enteros.
El valor de calendar
no puede ser null
.
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 year
parámetros , month
, day
hour
, 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
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
, , month
hour
day
, minute
, second
, , millisecond
y microsecond
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
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
offset
no representa los minutos enteros.
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
, , month
hour
day
, minute
, second
, , millisecond
y microsecond
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
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
offset
no representa los minutos enteros.
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de