Compartilhar via


Ações datetime

A ação Obter data e hora atuais para recuperar a data e hora atuais (ou apenas a data, se selecionada) e armazená-la em uma variável. O formato da data depende da configuração do Windows. Para obter mais informações sobre a sintaxe dos valores de data e hora, acesse Tipos de dados de variável.

Para adicionar várias unidades de tempo a variáveis de data, implemente a ação Adicionar a datetime.

Para calcular a diferença entre duas datas, use a ação Subtrair datas. Você pode recuperar a diferença em segundos, minutos, horas ou dias.

Captura de tela da ação Subtrair datas.

Adicionar a datetime

Adiciona (ou subtrai) um número específico de segundos, minutos, horas ou dias a um valor de datetime.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Datetime Não Data/hora O valor datetime a ser alterado
Add Não Valor numérico O valor numérico a ser adicionado. Para subtrair um tempo, o valor deve ser negativo. Por exemplo, adicione -7 dias aqui para voltar uma semana
Time unit N/D Segundos, Minutos, Horas, Dias, Meses, Anos Segundos A unidade de tempo que a hora a ser adicionada representa

Variáveis produzidas

Argumento Type Description
ResultedDate Data/hora O novo valor de datetime alterado

Exceções

Essa ação não inclui exceções.

Subtrair datas

Localiza a diferença de horário entre duas datas especificadas em dias, horas, minutos ou segundos.

Para subtrair uma determinada data de outra, use a ação Subtrair datas. Insira uma data válida na propriedade Data inicial para usar como base para subtrair a outra data. Em seguida, preencha a propriedade Subtrair data para calcular a diferença. Certifique-se de usar um tipo de variável Datetime válido aqui (para criar um, use a ação Obter data e hora atuais). Você pode especificar como a diferença retornada deve ser representada (em dias/horas/minutos/segundos) selecionando a respectiva opção na propriedade Obter diferença em.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
From date Não Data/hora O datetime do qual deseja subtrair o primeiro datetime. Esse será o datetime base e, por isso, geralmente coloque a última data/hora nesse atributo
Subtract date Não Data/hora O datetime a ser subtraído
Get difference in N/D Segundos, Minutos, Horas, Dias dias A unidade de tempo na qual a diferença será expressa

Variáveis produzidas

Argumento Type Description
TimeDifference Valor numérico A diferença em horário como um valor numérico

Exceções

Essa ação não inclui exceções.

Obter data e hora atuais

Recupera a data atual ou a data e hora atuais.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Retrieve N/D Data e hora atuais, Somente data atual Data e hora atuais Especifique se você obterá a data e a hora ou somente a data. Caso escolha o último, o valor do tempo será armazenado como meia-noite (0:00:00)
Time zone N/A Fuso horário do sistema, fuso horário específico (a ser preterido), Fuso horário do Windows, Entrada personalizada Fuso horário do sistema Especificar se o fuso horário do sistema deve ser usado ou selecionar um específico ou configurar um fuso horário manualmente
País/região Não Valor do texto Europa/Bucareste O país/região cuja hora será obtida ou adicionar um valor numérico como as horas que serão adicionadas ao fuso horário UTC
Fuso horário do Windows Não Disponível Fusos horários do Windows (UTC) Tempo Universal Coordenado Especificar o país/região de onde o fuso horário é obtido
Tipo de Entrada Não Compensação, Fuso horário do Windows Deslocamento Escolha se você deve definir a compensação por meio de um valor numérico ou fornecendo um fuso horário no formato do Windows
Deslocamento Não Valor numérico N/A Especificar o número de horas que a compensação terá. O formato de hora é UTC.
Time zone Não Valor do texto N/A Especificar o fuso horário (fuso horário do Windows)

Variáveis produzidas

Argumento Type Description
CurrentDateTime Data/hora O valor atual de datetime

Exceções

Exceção Descrição
Failed to get current date and time Indica que houve um problema ao recuperar a data e a hora atuais
Specified country/region not found Indica que o país ou a região especificado não foi encontrado