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.ConvertTimeBySystemTimeZoneId (DateTime, String)

 

Converte um horário para o horário em outro fuso horário com base no identificador do fuso horário.

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

public static DateTime ConvertTimeBySystemTimeZoneId(
	DateTime dateTime,
	string destinationTimeZoneId
)

Parâmetros

dateTime
Type: System.DateTime

A data e hora a ser convertida.

destinationTimeZoneId
Type: System.String

O identificador do fuso horário de destino.

Valor Retornado

Type: System.DateTime

A data e hora no fuso horário de destino.

Exception Condition
ArgumentNullException

destinationTimeZoneId é null.

InvalidTimeZoneException

O identificador de fuso horário foi encontrado, mas os dados do Registro estão corrompidos.

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 destinationTimeZoneId não foi encontrado no sistema local.

Ao executar a conversão, o ConvertTimeBySystemTimeZoneId método se aplica a quaisquer regras de ajuste em vigor no destinationTimeZoneId fuso horário.

Essa sobrecarga é praticamente idêntica ao chamar o ConvertTime(DateTime, TimeZoneInfo) método, exceto que ela permite que você especifique o fuso horário de destino por seu identificador em vez de uma referência de objeto. Esse método é mais útil quando você deve converter um tempo sem recuperar o objeto de fuso horário que corresponde a ele e você não precisa saber se o tempo convertido é standard ou do horário de verão.

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

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

Converte o tempo Universal Coordenado (UTC) para o horário em destinationTimeZone.

DateTimeKind.Unspecified

Presume-se que Local.

Converte a hora local na hora em destinationTimeZone.

O Kind propriedade retornado DateTime valor é definido como mostrado na tabela a seguir.

Condição

Retornou valor de tipo de propriedade

O destinationTimeZone é TimeZoneInfo.Utc.Id.

DateTimeKind.Utc

Qualquer outro destinationTimeZone valor.

DateTimeKind.Unspecified

Se o valor da dateTime parâmetro é uma hora local ambígua, ele será interpretado como um horário padrão. Se o dateTime parâmetro é uma hora local inválida, este método lança um 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 retorna o fuso horário cujo identificador é especificado pelo destinationTimeZoneId parâmetro do registro. Ele não pode recuperar um objeto de fuso horário que é criado usando o CreateCustomTimeZone método. A destinationTimeZoneId parâmetro deve corresponder exatamente a chave de registro do fuso horário de comprimento, mas não no caso, há uma correspondência ocorrer; ou seja, a comparação de destinationTimeZoneId com o fuso horário identificadores diferencia maiusculas de minúsculas.

.NET Framework
Disponível desde 3.5
Retornar ao início
Mostrar: