DateTimeOffset Construtores

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa uma nova instância da estrutura DateTimeOffset.

Sobrecargas

DateTimeOffset(DateTime)	Inicializa uma nova instância da estrutura DateTimeOffset usando o valor DateTime.
DateTimeOffset(DateTime, TimeSpan)	Inicializa uma nova instância da estrutura DateTimeOffset usando o valor DateTime e deslocamento especificados.
DateTimeOffset(Int64, TimeSpan)	Inicializa uma nova instância da estrutura DateTimeOffset usando o número de tiques e deslocamento especificados.
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Inicializa uma nova instância da DateTimeOffset estrutura usando , e `offset`especificados`datetime`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicializa uma nova instância da estrutura DateTimeOffset usando o ano, mês, dia, hora, minuto, segundo e deslocamento especificados.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicializa uma nova instância da estrutura DateTimeOffset usando o ano, mês, dia, hora, minuto, segundo, milissegundo e deslocamento especificados.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Inicializa uma nova instância da estrutura DateTimeOffset usando o ano, mês, dia, hora, minuto, segundo, milissegundo e deslocamento especificados de um calendário especificado.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicializa uma nova instância da DateTimeOffset estrutura usando o especificado`year`, , `daymonth`, `hour`, `minute`, `second`, `millisecondmicrosecond` e `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Inicializa uma nova instância da DateTimeOffset estrutura usando o especificado`year`, , `daymonth`, `hour`, `minute`, `second`, `millisecondmicrosecond` e `offset`.

DateTimeOffset(DateTime)

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Inicializa uma nova instância da estrutura DateTimeOffset usando o valor DateTime.

public:
 DateTimeOffset(DateTime dateTime);

public DateTimeOffset (DateTime dateTime);

new DateTimeOffset : DateTime -> DateTimeOffset

Public Sub New (dateTime As DateTime)

Parâmetros

dateTime: DateTime

Uma data e hora.

Exceções

ArgumentOutOfRangeException

A data e hora utc coordenadas que resultam da aplicação do deslocamento é anterior a DateTimeOffset.MinValue.

-ou-

A data e hora UTC resultantes da aplicação do deslocamento é posterior a DateTimeOffset.MaxValue.

Exemplos

O exemplo a seguir ilustra como o valor da DateTime.Kind propriedade do dateTime parâmetro afeta o valor de data e hora retornado por esse construtor.

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

Comentários

O comportamento desse construtor depende do valor da DateTime.Kind propriedade do dateTime parâmetro :

Se o valor de DateTime.Kind for DateTimeKind.Utc, a DateTime propriedade da nova instância será definida como dateTimee a Offset propriedade será definida como Zero.
Se o valor de DateTime.Kind for DateTimeKind.Local ou DateTimeKind.Unspecified, a DateTime propriedade da nova instância será definida como dateTimee a Offset propriedade será definida como igual ao deslocamento do fuso horário atual do sistema local.

Confira também

Instanciando um objeto DateTimeOffset

Aplica-se a

DateTimeOffset(DateTime, TimeSpan)

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Inicializa uma nova instância da estrutura DateTimeOffset usando o valor DateTime e deslocamento 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

Uma data e hora.

offset: TimeSpan

O deslocamento de tempo em relação ao Tempo Universal Coordenado (UTC).

Exceções

ArgumentException

dateTime.Kind é igual a Utc e offset não é igual a zero.

- ou -

dateTime.Kind é igual a Local e offset não é igual ao deslocamento do fuso horário local do sistema.

- ou -

O offset não está especificado em minutos inteiros.

ArgumentOutOfRangeException

offset é menor que -14 horas ou maior que 14 horas.

- ou -

UtcDateTime é menor que DateTimeOffset.MinValue ou maior que DateTimeOffset.MaxValue.

Exemplos

O exemplo a seguir mostra como inicializar um DateTimeOffset objeto com uma data e hora e o deslocamento do fuso horário local quando esse fuso horário não é conhecido com antecedência.

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

Comentários

O comportamento desse construtor depende, em parte, do valor da Kind propriedade do dateTime parâmetro :

Se o valor de Kind for DateTimeKind.Utc, o valor do offset parâmetro deverá ser 0 ou um ArgumentException será gerado.
Se o valor de Kind for DateTimeKind.Local, o offset valor do parâmetro deverá ser igual ao deslocamento do fuso horário local do UTC (Tempo Universal Coordenado) para essa data específica ou um ArgumentException será gerado.
Se o valor de Kind for DateTimeKind.Unspecified, o offset parâmetro poderá ter qualquer valor válido.

Confira também

Instanciando um objeto DateTimeOffset

Aplica-se a

DateTimeOffset(Int64, TimeSpan)

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Inicializa uma nova instância da estrutura DateTimeOffset usando o número de tiques e deslocamento 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

Uma data e hora expressada como o número de intervalos de 100 nanossegundos decorridos desde a meia noite de 1º de janeiro, 0001.

offset: TimeSpan

O deslocamento de tempo em relação ao Tempo Universal Coordenado (UTC).

Exceções

ArgumentException

O offset não está especificado em minutos inteiros.

ArgumentOutOfRangeException

A UtcDateTime propriedade é anterior a DateTimeOffset.MinValue ou posterior a DateTimeOffset.MaxValue.

- ou -

ticks é menor que DateTimeOffset.MinValue.Ticks ou maior que DateTimeOffset.MaxValue.Ticks.

- ou -

Offset é menor que -14 horas ou maior que 14 horas.

Exemplos

O exemplo a seguir inicializa um DateTimeOffset objeto usando o número de tiques em uma data arbitrária (neste caso, 16 de julho de 2007, às 13h32) com um deslocamento 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

Comentários

Normalmente, tentar chamar o DateTimeOffset construtor para instanciar um DateTimeOffset valor com uma hora local e um deslocamento diferente do fuso horário local lança um ArgumentException. Você pode usar essa sobrecarga do DateTimeOffset construtor para contornar essa limitação. O exemplo a seguir usa o número de tiques da hora local para instanciar um DateTimeOffset valor cujo deslocamento não representa necessariamente o da 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

Confira também

Instanciando um objeto DateTimeOffset

Aplica-se a

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Inicializa uma nova instância da DateTimeOffset estrutura usando , e offsetespecificadosdatetime.

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

A parte de data.

time: TimeOnly

A parte de tempo.

offset: TimeSpan

O deslocamento de tempo em relação ao Tempo Universal Coordenado (UTC).

Aplica-se a

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

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Inicializa uma nova instância da estrutura DateTimeOffset usando o ano, mês, dia, hora, minuto, segundo e deslocamento 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

O ano (de 1 a 9999).

month: Int32

O mês (de 1 a 12).

day: Int32

O dia (1 até o número de dias em month).

hour: Int32

As horas (de 0 a 23).

minute: Int32

Os minutos (de 0 a 59).

second: Int32

Os segundos (de 0 a 59).

offset: TimeSpan

O deslocamento de tempo em relação ao Tempo Universal Coordenado (UTC).

Exceções

ArgumentException

offset não representa minutos inteiros.

ArgumentOutOfRangeException

year é menor que um ou maior que 9.999.

- ou -

month é menor que um ou maior que 12.

- ou -

day é menor que um ou maior que o número de dias em month.

- ou -

hour é menor que zero ou maior que 23.

- ou -

minute é menor que 0 ou maior que 59.

- ou -

second é menor que 0 ou maior que 59.

- ou -

offset é menor que -14 horas ou maior que 14 horas.

- ou -

A UtcDateTime propriedade é anterior a DateTimeOffset.MinValue ou posterior a DateTimeOffset.MaxValue.

Exemplos

O exemplo a seguir cria uma instância de um DateTimeOffset objeto usando a sobrecarga do DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) construtor.

   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

Comentários

Este construtor interpreta year, month e day como um ano, mês e um dia no calendário gregoriano. Para criar uma instância de um DateTimeOffset valor usando o ano, o mês e o dia em outro calendário, chame o DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) construtor .

Confira também

Instanciando um objeto DateTimeOffset

Aplica-se a

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

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Inicializa uma nova instância da estrutura DateTimeOffset usando o ano, mês, dia, hora, minuto, segundo, milissegundo e deslocamento 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

O ano (de 1 a 9999).

month: Int32

O mês (de 1 a 12).

day: Int32

O dia (1 até o número de dias em month).

hour: Int32

As horas (de 0 a 23).

minute: Int32

Os minutos (de 0 a 59).

second: Int32

Os segundos (de 0 a 59).

millisecond: Int32

Os milissegundos (de 0 a 999).

offset: TimeSpan

O deslocamento de tempo em relação ao Tempo Universal Coordenado (UTC).

Exceções

ArgumentException

offset não representa minutos inteiros.

ArgumentOutOfRangeException

year é menor que um ou maior que 9.999.

- ou -

month é menor que um ou maior que 12.

- ou -

day é menor que um ou maior que o número de dias em month.

- ou -

hour é menor que zero ou maior que 23.

- ou -

minute é menor que 0 ou maior que 59.

- ou -

second é menor que 0 ou maior que 59.

- ou -

millisecond é menor que 0 ou maior que 999.

- ou -

offset é menor que -14 ou maior que 14.

- ou -

A UtcDateTime propriedade é anterior a DateTimeOffset.MinValue ou posterior a DateTimeOffset.MaxValue.

Exemplos

O exemplo a seguir cria uma instância de um DateTimeOffset objeto usando a sobrecarga do DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) construtor.

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

Comentários

Confira também

Instanciando um objeto DateTimeOffset

Aplica-se a

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

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Inicializa uma nova instância da estrutura DateTimeOffset usando o ano, mês, dia, hora, minuto, segundo, milissegundo e deslocamento especificados de um calendário 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

O ano.

month: Int32

O mês (de 1 a 12).

day: Int32

O dia (1 até o número de dias em month).

hour: Int32

As horas (de 0 a 23).

minute: Int32

Os minutos (de 0 a 59).

second: Int32

Os segundos (de 0 a 59).

millisecond: Int32

Os milissegundos (de 0 a 999).

calendar: Calendar

O calendário usado para interpretar year, month e day.

offset: TimeSpan

O deslocamento de tempo em relação ao Tempo Universal Coordenado (UTC).

Exceções

ArgumentException

offset não representa minutos inteiros.

ArgumentNullException

calendar não pode ser null.

ArgumentOutOfRangeException

year é menor que o MinSupportedDateTime.Year do parâmetro calendar ou maior que MaxSupportedDateTime.Year.

- ou -

month é menor que ou maior que o número de meses em year no calendar.

- ou -

day é menor que um ou maior que o número de dias em month.

- ou -

hour é menor que zero ou maior que 23.

- ou -

minute é menor que 0 ou maior que 59.

- ou -

second é menor que 0 ou maior que 59.

- ou -

millisecond é menor que 0 ou maior que 999.

- ou -

offset é menor que -14 horas ou maior que 14 horas.

- ou -

Os parâmetros year, month e day não podem ser representados como um valor de data e hora.

- ou -

A UtcDateTime propriedade é anterior a DateTimeOffset.MinValue ou posterior a DateTimeOffset.MaxValue.

Exemplos

O exemplo a seguir usa instâncias da HebrewCalendar classe e da HijriCalendar classe para instanciar um DateTimeOffset valor. Essa data é exibida no console usando os respectivos calendários e o calendário 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()

Comentários

Os yearparâmetros , month, day, hourminute, second, e millisecond refletem valores expressos no calendário especificado pelo calendar parâmetro . Uma exceção será gerada se esses valores formarem uma data e hora que não podem ser expressas usando esse calendário.

Importante

As eras nos calendários japoneses se baseiam no reinado do Imperador e, portanto, estão sujeitas a alterações. Por exemplo, 1º de maio de 2019 marcou o início da era Reiwa no JapaneseCalendar e no JapaneseLunisolarCalendar. Tal alteração de eras afeta todos os aplicativos que usam esses calendários. Para obter mais informações e determinar se seus aplicativos são afetados, consulte Manipulando uma nova era no calendário japonês no .NET. Para obter informações sobre como testar seus aplicativos em sistemas Windows para garantir sua preparação para a alteração da era, consulte Preparar seu aplicativo para a alteração da era japonesa. Para recursos no .NET que dão suporte a calendários com várias eras e para práticas recomendadas ao trabalhar com calendários que dão suporte a várias eras, consulte Trabalhando com eras.

Confira também

Instanciando um objeto DateTimeOffset

Aplica-se a

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

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Inicializa uma nova instância da DateTimeOffset estrutura usando os especificados year, month, day, hour, minute, second, milliseconde 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

O ano (de 1 a 9999).

month: Int32

O mês (de 1 a 12).

day: Int32

O dia (1 até o número de dias em month).

hour: Int32

As horas (de 0 a 23).

minute: Int32

Os minutos (de 0 a 59).

second: Int32

Os segundos (de 0 a 59).

millisecond: Int32

Os milissegundos (de 0 a 999).

microsecond: Int32

Os microssegundos (0 a 999).

offset: TimeSpan

O deslocamento de tempo em relação ao Tempo Universal Coordenado (UTC).

Exceções

ArgumentException

offset não representa minutos inteiros.

ArgumentOutOfRangeException

year é menor que 1 ou maior que 9999.

- ou -

month é menor que 1 ou maior que 12.

- ou -

day é menor que 1 ou maior que o número de dias em month.

- ou -

hour é menor que 0 ou maior que 23.

- ou -

minute é menor que 0 ou maior que 59.

- ou -

second é menor que 0 ou maior que 59.

- ou -

millisecond é menor que 0 ou maior que 999.

- ou -

microsecond é menor que 0 ou maior que 999.

Comentários

Este construtor interpreta yeare monthday como um ano, mês e dia no calendário gregoriano. Para criar uma instância de um DateTimeOffset valor usando o ano, o mês e o dia em outro calendário, chame o DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) construtor.

Aplica-se a

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

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Origem:: DateTimeOffset.cs

Inicializa uma nova instância da DateTimeOffset estrutura usando o especificadoyear, , daymonth, hour, minute, second, millisecondmicrosecond e 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

O ano (de 1 a 9999).

month: Int32

O mês (de 1 a 12).

day: Int32

O dia (1 até o número de dias em month).

hour: Int32

As horas (de 0 a 23).

minute: Int32

Os minutos (de 0 a 59).

second: Int32

Os segundos (de 0 a 59).

millisecond: Int32

Os milissegundos (de 0 a 999).

microsecond: Int32

Os microssegundos (0 a 999).

calendar: Calendar

O calendário usado para interpretar year, month e day.

offset: TimeSpan

O deslocamento de tempo em relação ao Tempo Universal Coordenado (UTC).

Exceções

ArgumentException

offset não representa minutos inteiros.

ArgumentOutOfRangeException

year não está no intervalo suportado por calendar.

- ou -

month é menor que 1 ou maior que o número de meses em calendar.

- ou -

day é menor que 1 ou maior que o número de dias em month.

- ou -

hour é menor que 0 ou maior que 23.

- ou -

minute é menor que 0 ou maior que 59.

- ou -

second é menor que 0 ou maior que 59.

- ou -

millisecond é menor que 0 ou maior que 999.

- ou -

microsecond é menor que 0 ou maior que 999.

- ou -

offset é menor que -14 horas ou maior que 14 horas.

- ou -

Os parâmetros year, month e day não podem ser representados como um valor de data e hora.

- ou -

A propriedade UtcDateTime é anterior a MinValue ou posterior a MaxValue.

Comentários

Esse construtor interpreta yeare monthday como um ano, mês e dia no calendário gregoriano. Para criar uma instância de um DateTimeOffset valor usando o ano, mês e dia em outro calendário, chame o DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) construtor .

Aplica-se a

DateTimeOffset Construtores

Definição

Sobrecargas

DateTimeOffset(DateTime)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

DateTimeOffset(DateTime, TimeSpan)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

DateTimeOffset(Int64, TimeSpan)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Parâmetros

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Comentários

Aplica-se a

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

Parâmetros

Exceções

Comentários

Aplica-se a

Comentários

Recursos adicionais