Funções de data e hora no mapeamento do fluxo de dados
APLICA-SE A: 
Azure Data Factory Azure Synapse Analytics
Gorjeta
Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange tudo, desde a movimentação de dados até ciência de dados, análises em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!
Os fluxos de dados estão disponíveis no Azure Data Factory e no Azure Synapse Pipelines. Este artigo aplica-se ao mapeamento de fluxos de dados. Se você é novo em transformações, consulte o artigo introdutório Transformar dados usando um fluxo de dados de mapeamento.
Os artigos a seguir fornecem detalhes sobre funções de data e hora suportadas pelo Azure Data Factory e pelo Azure Synapse Analytics no mapeamento de fluxos de dados.
Lista de funções de expressão
Nos pipelines Data Factory e Synapse, use funções de data e hora para expressar valores datetime e manipulá-los.
| Função de expressão | Task |
|---|---|
| adicionar | Adiciona um par de cadeias de caracteres ou números. Adiciona uma data a vários dias. Adiciona uma duração a um carimbo de data/hora. Acrescenta uma matriz de tipo semelhante a outra. O mesmo que o operador +. |
| addDias | Adicione dias a um carimbo de data ou hora. O mesmo que o operador + para a data. |
| adicionarMeses | Adicione meses a um carimbo de data ou hora. Opcionalmente, você pode passar um fuso horário. |
| entre | Verifica se o primeiro valor está entre dois outros valores, inclusive. Os valores numéricos, de cadeia de caracteres e de data/hora podem ser comparados |
| currentDate | Obtém a data atual em que esse trabalho começa a ser executado. Você pode passar um fuso horário opcional na forma de 'GMT', 'PST', 'UTC', 'America/Cayman'. O fuso horário local é usado como padrão. Consulte a classe Java para obter os SimpleDateFormat formatos disponíveis. https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| currentTimestamp | Obtém o carimbo de data/hora atual quando o trabalho começa a ser executado com o fuso horário local. |
| currentUTC | Obtém o carimbo de data/hora atual como UTC. Se você quiser que sua hora atual seja interpretada em um fuso horário diferente do fuso horário do cluster, você pode passar um fuso horário opcional na forma de 'GMT', 'PST', 'UTC' ou 'America/Cayman'. O padrão é o fuso horário atual. Consulte a classe Java para obter os SimpleDateFormat formatos disponíveis. https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. Para converter a hora UTC para um fuso horário diferente, use fromUTC(). |
| diadeMês | Obtém o dia do mês dado uma data. |
| diadesemana | Obtém o dia da semana dado uma data. 1 - Domingo, 2 - Segunda-feira ..., 7 - Sábado. |
| diadeano | Obtém o dia do ano dado uma data. |
| Dias | Duração em milissegundos para o número de dias. |
| deUTC | Converte para o carimbo de data/hora do UTC. Opcionalmente, você pode passar o fuso horário na forma de 'GMT', 'PST', 'UTC', 'America/Cayman'. O padrão é o fuso horário atual. Consulte a classe Java para obter os SimpleDateFormat formatos disponíveis. https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| hora | Obtém o valor da hora de um carimbo de data/hora. Você pode passar um fuso horário opcional na forma de 'GMT', 'PST', 'UTC', 'America/Cayman'. O fuso horário local é usado como padrão. Consulte a classe Java para obter os SimpleDateFormat formatos disponíveis. https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| hours | Duração em milissegundos para o número de horas. |
| isDate | Verifica se a cadeia de caracteres de data de entrada é uma data usando um formato de data de entrada opcional. Consulte SimpleDateFormat do Java para obter os formatos disponíveis. Se o formato de data de entrada for omitido, o formato padrão será yyyy-[M]M-[d]d. Os formatos aceites são: [ yyyy, yyyy-[M]M, yyyy-[M]M-[d]d, yyyy-[M]M-[d]dT* ] |
| isTimestamp | Verifica se a cadeia de caracteres de data de entrada é um carimbo de data/hora usando um formato opcional de carimbo de data/hora de entrada. Consulte SimpleDateFormat do Java para obter os formatos disponíveis. Se o carimbo de data/hora for omitido, o padrão yyyy-[M]M-[d]d hh:mm:ss[.f...] padrão será usado. Você pode passar um fuso horário opcional na forma de 'GMT', 'PST', 'UTC', 'America/Cayman'. O carimbo de data/hora suporta precisão de até milissegundos com valor de 999 Consulte o SimpleDateFormat do Java para obter os formatos disponíveis. |
| últimoDiadeMês | Obtém a última data do mês dada uma data. |
| milissegundos | Obtém o valor de milissegundos de uma data. Você pode passar um fuso horário opcional na forma de 'GMT', 'PST', 'UTC', 'America/Cayman'. O fuso horário local é usado como padrão. Consulte a classe Java para obter os SimpleDateFormat formatos disponíveis. https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| milissegundos | Duração em milissegundos para o número de milissegundos. |
| menos | Subtrai números. Subtraia o número de dias de uma data. Subtraia a duração de um carimbo de data/hora. Subtraia dois carimbos de data/hora para obter a diferença em milissegundos. O mesmo que o operador - . |
| minuto | Obtém o valor de minuto de um carimbo de data/hora. Você pode passar um fuso horário opcional na forma de 'GMT', 'PST', 'UTC', 'America/Cayman'. O fuso horário local é usado como padrão. Consulte a classe Java para obter os SimpleDateFormat formatos disponíveis. https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| minutes | Duração em milissegundos para o número de minutos. |
| mês | Obtém o valor do mês de um carimbo de data ou hora. |
| mesesEntre | Obtém o número de meses entre duas datas. Você pode completar o cálculo. Você pode passar um fuso horário opcional na forma de 'GMT', 'PST', 'UTC', 'America/Cayman'. O fuso horário local é usado como padrão. Consulte a classe Java para obter os SimpleDateFormat formatos disponíveis. https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| segundo | Obtém o segundo valor de uma data. Você pode passar um fuso horário opcional na forma de 'GMT', 'PST', 'UTC', 'America/Cayman'. O fuso horário local é usado como padrão. Consulte a classe Java para obter os SimpleDateFormat formatos disponíveis. https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| segundos | Duração em milissegundos para o número de segundos. |
| subDias | Subtraia dias de um carimbo de data ou hora. O mesmo que o operador - para a data. |
| subMeses | Subtraia meses de um carimbo de data ou hora. |
| até à data | Converte a cadeia de caracteres de data de entrada em data usando um formato de data de entrada opcional. Consulte a classe Java para obter os SimpleDateFormat formatos disponíveis. Se o formato de data de entrada for omitido, o formato padrão será aaaa-[M]M-[d]d. Os formatos aceites são:[ aaaa, aaaa-[M]M, aaaa-[M]M-[d]d, aaaa-[M]M-[d]dT* ]. |
| paraCarimbo de data/hora | Converte uma cadeia de caracteres em um carimbo de data/hora com um formato opcional de carimbo de data/hora. Se o carimbo de data/hora for omitido, o padrão padrão aaaa-[M]M-[d]d hh:mm:ss[.f...] será usado. Você pode passar um fuso horário opcional na forma de 'GMT', 'PST', 'UTC', 'America/Cayman'. O carimbo de data/hora suporta precisão de até milissegundos com valor de 999. Consulte a classe Java para obter os SimpleDateFormat formatos disponíveis. https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| toUTC | Converte o carimbo de data/hora em UTC. Você pode passar um fuso horário opcional na forma de 'GMT', 'PST', 'UTC', 'America/Cayman'. O padrão é o fuso horário atual. Consulte a classe Java para obter os SimpleDateFormat formatos disponíveis. https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| semanadeano | Obtém a semana do ano dada uma data. |
| semanas | Duração em milissegundos para o número de semanas. |
| ano | Obtém o valor do ano de uma data. |