inweektodate – função de script e gráfico
Essa função retornará True se timestamp estiver na parte da semana que contém a base_date até e inclusive o último milissegundo da base_date.
Sintaxe:
InWeekToDate (timestamp, base_date, period_no [, first_week_day])
Tipo de dados de retorno: Booleano
Argumentos:
Argumento | Descrição |
---|---|
timestamp | A data que você deseja comparar com base_date. |
base_date | Data que é usada para avaliar a semana. |
period_no | A semana pode ser deslocada por period_no. period_no é um inteiro, em que o valor 0 indica a semana que contém base_date. Os valores negativos em period_no indicam semanas precedentes e os valores positivos indicam semanas subsequentes. |
first_week_day |
Por padrão, o primeiro dia da semana é segunda-feira, iniciando entre domingo e segunda-feira. Para indicar se o início da semana for outro dia, especifique um deslocamento em first_week_day. Esse deslocamento pode ser dado como um número total de dias e/ou frações de um dia. |
Exemplo 1:
inweektodate ('12/01/2006', '12/01/2006', 0)
Retorna True
Exemplo 2:
inweektodate ('12/01/2006', '11/01/2006', 0)
Retorna False
Exemplo 3:
inweektodate ('12/01/2006', '18/01/2006', -1)
Retorna False
Como period_no está especificado como -1, os dados eficazes contra os quais timestamp é medido são 11/01/2006.
Exemplo 4:
inweektodate ( '11/01/2006', '12/01/2006', 0, 3 )
Retorna False
Como first_week_day está especificado como 3 (quinta-feira), isso faz com que 12/01/2006 seja o primeiro dia da semana seguinte à semana contendo 12/01/2006.
Exemplo 5:
Adicione o script de exemplo ao seu documento e execute-o. Em seguida, adicione pelo menos os campos listados na coluna de resultados a um documento para ver o resultado.
Este exemplo confere se uma data da fatura está dentro da quarta semana seguinte à semana em base_date, ao especificar period_no como 4, mas antes do valor d base_date.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
InWeekToDate(InvDate, '11/01/2013', 4) AS InWeek2DPlus4
Resident TempTable;
Drop table TempTable;
A tabela resultante contém as datas originais e uma coluna com o valor de retorno da função inweek().
InvDate | InWeek2DPlus4 |
---|---|
28/03/2012 | 0 (False) |
10/12/2012 | 0 (False) |
5/2/2013 | -1 (True) |
31/3/2013 | 0 (False) |
19/5/2013 | 0 (False) |
15/9/2013 | 0 (False) |
11/12/2013 | 0 (False) |
2/3/2014 | 0 (False) |
14/5/2014 | 0 (False) |
13/6/2014 | 0 (False) |
7/7/2014 | 0 (False) |
4/8/2014 | 0 (False) |