Esta página foi útil?
Seus comentários sobre este conteúdo são importantes. Queremos saber sua opinião.
Comentários adicionais?
1500 caracteres restantes
Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Método TimeZoneInfo.ConvertTimeBySystemTimeZoneId (DateTime, String)

Converte uma hora a hora em outro fuso horário com base no identificador de fuso horário.

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

public static DateTime ConvertTimeBySystemTimeZoneId(
	DateTime dateTime,
	string destinationTimeZoneId
)

Parâmetros

dateTime
Tipo: System.DateTime
A data e hora a ser convertida.
destinationTimeZoneId
Tipo: System.String
O identificador de fuso horário de destino.

Valor de retorno

Tipo: System.DateTime
A data e hora no fuso horário de destino.

ExceçãoCondição
ArgumentNullException

destinationTimeZoneId é null.

InvalidTimeZoneException

O identificador de fuso horário foi localizado, mas os dados de Registro está danificado.

SecurityException

O processo não tem as permissões necessárias para ler a partir da chave do Registro que contém as informações de fuso horário.

TimeZoneNotFoundException

O identificador de destinationTimeZoneId não foi localizado no sistema local.

Ao executar a conversão, o método de ConvertTimeBySystemTimeZoneId aplica todas as regras de ajuste aplicado no fuso horário de destinationTimeZoneId .

Essa sobrecarga em grande parte é idêntica a chamar o método de ConvertTime(DateTime, TimeZoneInfo) , exceto que permite especificar o fuso horário de destino por seu identificador em vez de por uma referência de objeto. Esse método é mais útil quando você precisa converter vez sem recuperar o objeto de fuso horário que ele corresponda e você não precisa saber se a hora são convertidos padrão ou horário de verão.

O método de ConvertTimeBySystemTimeZoneId(DateTime, String) determina o fuso horário da origem do valor da propriedade de Kind do parâmetro de dateTime , pois a tabela a seguir mostra.

Valor da propriedade do tipo

Fuso horário de origem

Comportamento do método

DateTimeKind.Local

Local

Converte a hora local na hora em destinationTimeZone.

DateTimeKind.Utc

Utc

Tempo Universal Coordenado (UTC) de converte a hora em destinationTimeZone.

DateTimeKind.Unspecified

Assume-se Local.

Converte a hora local na hora em destinationTimeZone.

A propriedade de Kind do valor retornado de DateTime é definida como mostra a tabela a seguir.

Condição

Valor da propriedade tipo retornado

O destinationTimeZone é TimeZoneInfo.Utc.Id.

DateTimeKind.Utc

Qualquer outro valor de destinationTimeZone .

DateTimeKind.Unspecified

Se o valor do parâmetro de dateTime é hora locais ambíguas, ele será interpretado como uma hora padrão. Se o parâmetro de dateTime é hora locais inválidos, gera esse método ArgumentException.

Caso a conversão de dateTime resulte em uma data e um valor de hora anterior a DateTime.MinValue ou posterior a DateTime.MaxValue, este método retorna DateTime.MinValue ou DateTime.MaxValue, respectivamente.

Esse método recupera o fuso horário cujo identificador é especificado pelo parâmetro de destinationTimeZoneId do Registro. Não é possível recuperar um objeto de fuso horário que é criado usando o método de CreateCustomTimeZone . O parâmetro de destinationTimeZoneId deve corresponder exatamente à chave do Registro de fuso horário de comprimento, mas não caso que, para que uma correspondência ocorre com êxito; isto é, a comparação de destinationTimeZoneId com identificadores de fuso horário não diferencia maiúsculas de minúsculas.

.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2015 Microsoft