Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
EXTRACT
Retorna parte de uma data.
Exemplo de uso
EXTRACT(QUARTER FROM Order Date)
Sintaxe
1) Retorna uma parte da data.
EXTRACT( part FROM date_expression )
2) Retorna um valor de "Data" de um campo ou expressão de "Data e hora".
EXTRACT(DATE FROM date_expression )
Parâmetros
date_expression: campo ou expressão de "Data" ou "Data e hora".
part: a parte da data a ser retornada. EXTRACT é compatível com as seguintes partes:
DAYOFWEEK : retorna valores no intervalo [1, 7] com domingo como primeiro dia da semana.
DAY
DAYOFYEAR
WEEK : retorna o número da semana da data no intervalo [0, 53]. As semanas começam no domingo. Os dias anteriores ao primeiro domingo do ano estão na semana 0.
ISOWEEK : retorna o número da semana ISO 8601 de date_expression -. Os ISOWEEK começam na segunda-feira. Retorna valores no intervalo [1, 53]. O primeiro ISOWEEK de cada ano ISO começa na segunda-feira antes da primeira quinta-feira do ano do calendário gregoriano.
MONTH
QUARTER : retorna valores no intervalo [1, 4].
YEAR
ISOYEAR : retorna o ano da numeração da semana ISO 8601, que é o ano do calendário gregoriano que contém a quinta-feira da semana à qual date_expression pertence.
Tipos de dados retornados
Número (inteiro)
Data
Exemplos
No exemplo a seguir, EXTRACT retorna um valor correspondente à parte de hora de DAY.
Exemplo de fórmula
Saída
EXTRACT(DAY FROM DATE '2013-12-25')
25
No exemplo a seguir, EXTRACT retorna valores correspondentes a diferentes partes de hora de uma coluna de datas próximas ao fim do ano.
Nome do campo
Exemplo de fórmula
Isoyear
EXTRACT(ISOYEAR FROM Date)
Isoweek
EXTRACT(ISOWEEK FROM Date)
Year
EXTRACT(YEAR FROM Date)
Week
EXTRACT(WEEK FROM Date)
Saída:
Data de entrada
Isoyear
Semana ISO
Ano
Semana
2015-12-23
2015
52
2015
51
2015-12-24
2015
52
2015
51
2015-12-25
2015
52
2015
51
2015-12-26
2015
52
2015
51
2015-12-27
2015
52
2015
52
2015-12-28
2015
53
2015
52
2015-12-29
2015
53
2015
52
2015-12-30
2015
53
2015
52
2015-12-31
2015
53
2015
52
2016-01-01
2015
53
2016
0
2016-01-02
2015
53
2016
0
2016-01-03
2015
53
2016
1
2016-01-04
2016
1
2016
1
2016-01-05
2016
1
2016
1
2016-01-06
2016
1
2016
1
2016-01-07
2016
1
2016
1
2016-01-08
2016
1
2016
1
2016-01-09
2016
1
2016
1
Observações
Essa 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-31 UTC."],[],[],null,["EXTRACT\n=======\n\nReturns part of a date.\n\nSample usage\n------------\n\n`EXTRACT(QUARTER FROM Order Date)`\n\nSyntax\n------\n\n1) Returns a date part.\n\n`EXTRACT( `\u003cvar translate=\"no\"\u003epart\u003c/var\u003e` FROM `\u003cvar translate=\"no\"\u003edate_expression\u003c/var\u003e` )`\n\n2) Returns a Date from a Date \\& Time field or expression.\n\n`EXTRACT(DATE FROM `\u003cvar translate=\"no\"\u003edate_expression\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 date part to return. `EXTRACT` supports the following parts:\n\n- `DAYOFWEEK` : Returns values in the range \\[1, 7\\] with Sunday as the first day of the week.\n- `DAY`\n- `DAYOFYEAR`\n- `WEEK` : Returns the week number of the date in the range \\[0, 53\\]. Weeks begin with Sunday, and dates prior to the first Sunday of the year are in week 0.\n- `ISOWEEK` : Returns the [ISO 8601 week](https://en.wikipedia.org/wiki/ISO_week_date) number of the \u003cvar translate=\"no\"\u003edate_expression\u003c/var\u003e -. `ISOWEEK` s begin on Monday. Returns values in the range \\[1, 53\\]. The first `ISOWEEK` of each ISO year begins on the Monday before the first Thursday of the Gregorian calendar year.\n- `MONTH`\n- `QUARTER` : Returns values in the range \\[1, 4\\].\n- `YEAR`\n- `ISOYEAR` : Returns the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) week-numbering year, which is the Gregorian calendar year containing the Thursday of the week to which \u003cvar translate=\"no\"\u003edate_expression\u003c/var\u003e - belongs.\n\nReturn data types\n-----------------\n\n1. **Number** (integer)\n2. **Date**\n\nExamples\n--------\n\nIn the following example, `EXTRACT` returns a value corresponding to the `DAY` time part.\n\nIn the following example, `EXTRACT` returns values corresponding to different time parts from a column of dates near the end of the year.\n\n**Output:**\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)"]]
