Time2Num

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

Sintaxe

Time2Num(d [, f [, k ]])

Parâmetros

Parâmetro

Descrição

d

Uma string de hora no formato fornecido por f que também está em conformidade com a localidade informada por k.

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 Time2Num:

Expressão

Retorna

Time2Num("00:00:00 GMT", "HH:MM:SS Z")

1

Time2Num("1:13:13 PM")

76393001 para um usuário na Califórnia no Horário Padrão do Pacífico e 76033001 quando o mesmo usuário está no Horário de Verão do Pacífico.

Time2Num("13:13:13", "HH:MM:SS") - Time2Num("13:13:13 GMT", "HH:MM:SS Z")) / (60 * 60 * 1000)

8 para um usuário em Vancouver e 5 para um usuário em Ottawa no Horário Padrão. No Horário de Verão, os valores retornados são 7 e 4, respectivamente.

Time2Num("13:13:13 GMT", "HH:MM:SS Z", "fr_FR")

47593001