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

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

Esta função retorna um valor correspondente à data/hora com o primeiro milissegundo do primeiro dia do mês que contém date. O formato de saída padrão será o DateFormat definido no script.

Sintaxe:  

MonthStart(date[, period_no])

Tipo de dados de retorno: dual

Diagrama da função monthstart()

Exemplo de diagrama de como os elementos da função trabalham juntos para retornar o resultado.

A função monthstart() determina em qual mês a data cai. Em seguida, ela retorna um carimbo de data/hora, em formato de data, para o primeiro milissegundo daquele mês.

Argumentos
Argumento Descrição
date A data ou o carimbo de data/hora a ser avaliado.
period_no period_no é um inteiro, no qual, se 0 ou omitido, indica o mês que contém date. Valores negativos em period_no indicam meses precedentes e valores positivos indicam meses sucessivos.

Quando usar

A função monthstart() é comumente usada como parte de uma expressão quando o usuário deseja que o cálculo use a fração do mês decorrido até o momento. Por exemplo, ela pode ser usada para calcular os juros acumulados em um mês até uma determinada data.

Exemplos de funções
Exemplo Resultado
monthstart('10/19/2001') Retorna 10/01/2001.
monthstart('10/19/2001', -1) Retorna 09/01/2001.

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: Exemplo de objeto de gráfico

Exemplo 4: 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!