Num2Time

Retorna uma string de hora, considerando um número de milissegundos desde a época.

Sintaxe

Num2Time(n [,f [, k ]])

Parâmetros

Parâmetro

Descrição

n

Um número inteiro que representa o número de milissegundos.

Se n for inválido, a função retornará um erro.

f (opcional)

Uma string de formato de hora. Se um valor para f não for incluído, a função usará o formato de hora padrão H:MM:SS A.

k (opcional)

Uma string identificadora de localidade que está em conformidade com os padrões de nomeação de localidades. Se um valor para k não for incluído ou se k for inválido, a função usará a localidade de ambiente.

A função retornará um valor de 0 se uma das condições a seguir for verdadeira:

  • O formato da hora fornecida não coincidir com o formato especificado na função.

  • A localidade ou o formato de hora fornecido na função for inválido.

    Informações insuficientes são fornecidas para determinar uma hora exclusiva desde a época (ou seja, informações referentes à hora estão ausentes ou incompletas).

Exemplos

As expressões a seguir ilustram o uso da função Num2Time:

Expressão

Retorna

Num2Time(1, "HH:MM:SS")

00:00:00 em Greenwich, Inglaterra e 09:00:00 em Tóquio.

Num2Time(65593001, "HH:MM:SS Z")

13:13:13 EST em Boston, EUA.

Num2Time(65593001, "HH:MM:SS Z", "de_DE")

13:13:13 GMT-05:00 para um usuário suíço-alemão em Boston, EUA.

Num2Time(43993001, TimeFmt(4, "de_DE"), "de_DE")

13.13 Uhr GMT+01:00 para um usuário em Zurique, Áustria.

Num2Time(43993001, "HH:MM:SSzz")

13:13+01:00 para um usuário em Zurique, Suíça.