Ir para conteúdo principal Pular para conteúdo complementar

monthsstart – função de script e gráfico

Essa função retorna um valor correspondente ao carimbo de data/hora do primeiro milissegundo do mês, bimestre, trimestre, quadrimestre ou semestre contendo uma data base. Também é possível descobrir a data/hora de um período de tempo anterior ou seguinte.O formato de saída padrão é o DateFormat definido no script.

Sintaxe:  

MonthsStart(n_months, date[, period_no [, first_month_of_year]])

Tipo de dados de retorno: dual

Diagrama da função monthsstart()

Diagrama de exemplo mostrando como cada um dos elementos da função trabalha em conjunto para retornar o resultado do carimbo de data/hora.

A função monthsstart() divide o ano em segmentos com base no argumento n_months fornecido. Em seguida, ela avalia em qual segmento cada data fornecida se encaixa e retorna o primeiro milissegundo desse segmento, em formato de data. A função também fornece a capacidade de retornar o carimbo de data/hora inicial dos segmentos anteriores ou seguintes, bem como de redefinir qual é o primeiro mês do ano.

Os seguintes segmentos do ano estão disponíveis na função como argumentos n_month:

Possíveis argumentos n_month
Períodos Número de meses
mês 1
bimestre 2
trimestre 3
quadrimestre

4

semestre 6
Argumentos
Argumento Descrição
n_months O número de meses que define o período. Um inteiro ou uma expressão que se resolve como um inteiro que deve ser um dos seguintes: 1 (equivalente à função inmonth()), 2 (bimestre), 3 (equivalente à função inquarter()), 4 (quadrimestre) ou 6 (semestre).
date A data ou o carimbo de data/hora a ser avaliado.
period_no O período pode ser deslocado por period_no, um inteiro ou expressão que resolve um inteiro, no qual o valor 0 indica o período que contém base_date. Valores negativos em period_no indicam períodos precedentes e valores positivos indicam períodos sucessivos.
first_month_of_year

Se desejar trabalhar com anos (fiscais) que não comecem em janeiro, indique um valor entre 2 e 12 em first_month_of_year.

Quando usar

A função monthsstart() é normalmente usada como parte de uma expressão quando o usuário deseja que o cálculo use a fração de um período que ainda não ocorreu. Isso pode ser usado, por exemplo, para fornecer uma variável de entrada para permitir que o usuário calcule o total de juros acumulados até o momento no mês, trimestre ou semestre.

Exemplos de funções
Exemplo Resultado
monthsstart(4, '10/19/2013') Retorna 09/01/2013.
monthsstart(4, '10/19/2013, -1) Retorna 05/01/2013.
monthsstart(4, '10/19/2013', 0, 2 ) Retorna 10/01/2013, porque o início do ano se torna o mês 2.

Configurações regionais

A menos que especificado de outra forma, os exemplos neste tópico usam o seguinte formato de data: MM/DD/AAAA. O formato de data é especificado na instrução SET DateFormat no seu script de carregamento de dados. A formatação de data padrão pode ser diferente no seu sistema devido às suas configurações regionais e outros fatores. Você pode alterar os formatos nos exemplos abaixo para atender às suas necessidades. Ou pode alterar os formatos no seu script de carregamento para corresponder a esses exemplos. Para obter mais informações, consulte Modificando configurações regionais para aplicativos e scripts.

As configurações regionais padrão nos aplicativos são baseadas no perfil do usuário. Essas configurações de formato regional não estão relacionadas ao idioma exibido na interface do usuário do Qlik Cloud. O Qlik Cloud será exibido no mesmo idioma do navegador que você está usando.

Se você for um criador de aplicativos, poderá definir a região padrão para os aplicativos que criar. Para obter mais informações, consulte Definir suas configurações regionais preferidas para criar aplicativos e scripts no Qlik Cloud Analytics.

Exemplo 1: Sem argumentos adicionais

Exemplo 2: period_no

Exemplo 3: first_month_of_year

Exemplo 4: Exemplo de objeto de gráfico

Exemplo 5: Cenário

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!