Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
DATETIME_TRUNC
Trunca uma data com a granularidade especificada.
Exemplo de uso
DATETIME_TRUNC(Order Date, MONTH)
Sintaxe
DATETIME_TRUNC( date_expression, part )
Parâmetros
date_expression: uma expressão ou um campo "Data" ou "Data e hora".
part: período de retorno. DATETIME_TRUNC é compatível com as seguintes partes do tempo:
MICROSECOND: disponível para campos ou expressões de "Data e hora".
MILLISECOND: disponível para campos ou expressões de "Data e hora".
SECOND: disponível para campos ou expressões de "Data e hora".
MINUTE: disponível para campos ou expressões de "Data e hora".
HOUR: disponível para campos ou expressões de "Data e hora".
DAY
WEEK: esta parte da data começa no domingo.
ISOWEEK: usa limites da semana ISO 8601. As semanas ISO começam na segunda-feira.
MONTH
QUARTER
YEAR
ISOYEAR: usa o limite de ano de numeração da semana ISO 8601. O limite do ano ISO é a segunda-feira da primeira semana que contém a quinta-feira pertencente ao ano do calendário gregoriano correspondente.
No exemplo a seguir, a date_expression original está no ano 2015 do calendário gregoriano. No entanto, DATE_TRUNC com a parte da data ISOYEAR trunca a date_expression com o início do ano ISO, não o ano do calendário gregoriano. A primeira quinta-feira do ano-calendário de 2015 foi 2015-01-01, então o ano ISO 2015 começa na segunda-feira anterior, 2014-12-29. Portanto, o limite do ano ISO anterior a date_expression 2015-06-15 é 2014-12-29.
Exemplo de fórmula
Saída
DATE_TRUNC('2015-06-15', ISOYEAR)
2014-12-29
EXTRACT(ISOYEAR FROM DATETIME '2015-06-15')
2015
Observações
Esta função não está disponível para os tipos de data do modo de compatibilidade.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-30 UTC."],[],[],null,["DATETIME_TRUNC\n==============\n\nTruncates a date to the specified granularity.\n\nSample usage\n------------\n\n`DATETIME_TRUNC(Order Date, MONTH)`\n\nSyntax\n------\n\n`DATETIME_TRUNC( `\u003cvar translate=\"no\"\u003edate_expression\u003c/var\u003e`, `\u003cvar translate=\"no\"\u003epart\u003c/var\u003e` )`\n\n### Parameters\n\n\u003cvar translate=\"no\"\u003edate_expression\u003c/var\u003e - a Date or a Date \\& Time field or expression.\n\n\u003cvar translate=\"no\"\u003epart\u003c/var\u003e - the time part to return. `DATETIME_TRUNC` supports the following time parts:\n\n- `MICROSECOND`: available for Date \\& Time fields or expressions.\n- `MILLISECOND`: available for Date \\& Time fields or expressions.\n- `SECOND`: available for Date \\& Time fields or expressions.\n- `MINUTE`: available for Date \\& Time fields or expressions.\n- `HOUR`: available for Date \\& Time fields or expressions.\n- `DAY`\n- `WEEK`: This date part begins on Sunday.\n- `ISOWEEK`: Uses [ISO 8601 week](https://en.wikipedia.org/wiki/ISO_week_date) boundaries. ISO weeks begin on Monday.\n- `MONTH`\n- `QUARTER`\n- `YEAR`\n- `ISOYEAR`: Uses the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) week-numbering year boundary. The ISO year boundary is the Monday of the first week whose Thursday belongs to the corresponding Gregorian calendar year.\n\nReturn data type\n----------------\n\nDate \\& Time\n\nExamples\n--------\n\nIn the following example, the original date_expression is in the Gregorian calendar year 2015. However, DATE_TRUNC with the ISOYEAR date part truncates the date_expression to the beginning of the ISO year, not the Gregorian calendar year. The first Thursday of the 2015 calendar year was 2015-01-01, so the ISO year 2015 begins on the preceding Monday, 2014-12-29. Therefore the ISO year boundary preceding the date_expression 2015-06-15 is 2014-12-29.\n\nNotes\n-----\n\nThis function is not available for compatibility mode date types.\n\nRelated resources\n-----------------\n\n- [Dates and times](/looker/docs/studio/dates-and-times)\n- [Calculated fields](/looker/docs/studio/about-calculated-fields)\n- [Looker Studio function list](/looker/docs/studio/function-list)"]]
