Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método TimeZoneInfo.IsInvalidTime (DateTime)

 

Indica se uma data e hora determinada é inválida.

Namespace:   System
Assembly:  mscorlib (em mscorlib.dll)

public bool IsInvalidTime(
	DateTime dateTime
)

Parâmetros

dateTime
Type: System.DateTime

Um valor de data e hora.

Valor Retornado

Type: System.Boolean

true se dateTime for inválida, caso contrário, false.

Um horário inválido se enquadra em um intervalo de horas para o fuso horário atual que não pode ser mapeado para o tempo Universal Coordenado (UTC), devido ao aplicativo de uma regra de ajuste. Normalmente, inválidos vezes ocorrem quando o tempo avança para o horário de verão. Consulte a seção de exemplo para obter uma ilustração.

O valor da Kind propriedade o dateTime parâmetro afeta se dateTime representa um período inválido, como mostra a tabela a seguir.

Propriedade Kind

Objeto TimeZoneInfo (se aplicável)

Comportamento

DateTimeKind.Local

TimeZoneInfo.Local

Determina se a hora é inválida.

DateTimeKind.Local

TimeZoneInfo.Utcou uma zona de tempo de local.

Converte dateTime do tempo do TimeZoneInfo objeto e retorna false.

DateTimeKind.Unspecified

Não aplicável.

Assume dateTime é a hora do TimeZoneInfo do objeto e determina se ele é inválido.

DateTimeKind.Utc

Não aplicável.

Retorna false.

Observações para os Autores de Chamada:

Em Windows XP sistemas, esse método se aplica apenas a regra de ajuste se a instância atual é TimeZoneInfo.Local. Como resultado, o método pode não relatar com precisão se dateTime é um horário inválido para períodos antes da regra de ajuste atual foi originada em vigor. Para obter mais informações, consulte que as notas da Seção Chamadores na propriedade Local.

O fuso horário do Pacífico, o horário de verão começa às 2:00 em 2 de abril de 2006. O código a seguir passa para o tempo em intervalos de um minuto de 1:59 A.M. em 2 de abril de 2006, para 3:01: 00h em 2 de abril de 2006, o IsInvalidTime método de um TimeZoneInfo objeto que representa o fuso horário do Pacífico. A saída do console indica que todos os tempos de 2:00 em 2 de abril de 2006, para 2:59:00 em 2 de abril de 2006 são inválidos.

// Specify DateTimeKind in Date constructor
DateTime baseTime = new DateTime(2007, 3, 11, 1, 59, 0, DateTimeKind.Unspecified);
DateTime newTime;

// Get Pacific Standard Time zone
TimeZoneInfo pstZone = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time");

// List possible invalid times for a 63-minute interval, from 1:59 AM to 3:01 AM
for (int ctr = 0; ctr < 63; ctr++)
{
   // Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
   newTime = baseTime.AddMinutes(ctr);
   Console.WriteLine("{0} is invalid: {1}", newTime, pstZone.IsInvalidTime(newTime));
}

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 3.5
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Retornar ao início
Mostrar: