addWorkDays

addWorkDays aggiunge o sottrae un determinato numero di giorni lavorativi a un determinato valore di data. La funzione restituisce una data per un giorno lavorativo, che corrisponde a un determinato giorno lavorativo dopo o prima di un determinato valore di data di input.

Sintassi

addWorkDays(initDate, numWorkDays)

Argomenti

initDate

Una NULL data diversa valida che funge da data di inizio del calcolo.

• Campo del set di dati: qualsiasi campo date del set di dati a cui si sta aggiungendo questa funzione.

• Funzione Data: qualsiasi data emessa da un'altra funzione date, ad esempio parseDate, epochDate, addDateTime e così via.

  addWorkDays(epochDate(1659484800), numWorkDays)

• Campi calcolati: qualsiasi campo QuickSight calcolato che restituisce un date valore.

  calcFieldStartDate = addDateTime(10, “DD”, startDate)
  addWorkDays(calcFieldStartDate, numWorkDays)

• Parametri: qualsiasi QuickSight datetime parametro.

  addWorkDays($paramStartDate, numWorkDays)

• Qualsiasi combinazione dei valori degli argomenti sopra indicati.

numWorkDays

Un numero non NULL intero che funge da data di fine del calcolo.

• Letterale: un valore letterale intero digitato direttamente nell'editor delle espressioni.

• Campo del set di dati: qualsiasi campo di data del set di dati

• Funzione o calcolo scalare: qualsiasi QuickSight funzione scalare che restituisce un output intero da un'altra, ad esempio decimalToIntabs, e così via.

  addWorkDays(initDate, decimalToInt(sqrt (abs(numWorkDays)) ) )

• Campo calcolato: qualsiasi campo QuickSight calcolato che restituisce un valore. date

  someOtherIntegerCalcField = (num_days * 2) + 12
  addWorkDays(initDate, someOtherIntegerCalcField)

• Parametro: qualsiasi QuickSight datetime parametro.

  addWorkDays(initDate, $param_numWorkDays)

• Qualsiasi combinazione dei valori degli argomenti sopra indicati.

Tipo restituito

Numero intero

Valori di output

I valori di output previsti includono:

• Numero intero positivo (quando start_date < end_date)

• Numero intero negativo (quando start_date > end_date)

• NULLquando uno o entrambi gli argomenti ottengono un valore nullo da. dataset field

Errori di input

I valori degli argomenti non consentiti causano errori, come illustrato negli esempi seguenti.

• L'uso di un valore letterale NULL come argomento nell'espressione non è consentito.

  addWorkDays(NULL, numWorkDays) 

  Error
  At least one of the arguments in this function does not have correct type. 
  Correct the expression and choose Create again.

• L'utilizzo di una stringa letterale come argomento o di qualsiasi altro tipo di dati diverso dalla data nell'espressione non è consentito. Nell'esempio seguente, la stringa "2022-08-10" ha l'aspetto di una data, ma in realtà è una stringa. Per utilizzarla, è necessario utilizzare una funzione che converta in un tipo di dati di data.

  addWorkDays("2022-08-10", 10)

  Error
  Expression addWorkDays("2022-08-10", numWorkDays) for function addWorkDays has 
  incorrect argument type addWorkDays(String, Number). 
  Function syntax expects Date, Integer.

Esempio

Un numero intero positivo come l'argomento numWorkDays produrrà una data futura della data di input. Un numero intero negativo come l'argomento numWorkDays produrrà una data risultante successiva alla data di input. Un valore zero per l'argomento numWorkDays restituisce lo stesso valore della data di input indipendentemente dal fatto che ricada in un giorno lavorativo o in un fine settimana.

La funzione addWorkDays funziona con la granularità: DAY. La precisione non può essere preservata con alcuna granularità inferiore o superiore al livello DAY.

addWorkDays(startDate, endDate)

Supponiamo che esista un campo denominato employmentStartDate con i seguenti valori:

2022-08-10 2022-08-06 2022-08-07 

Utilizzando il campo precedente e i seguenti calcoli, addWorkDays restituisce i valori modificati come illustrato di seguito:

addWorkDays(employmentStartDate, 7)

2022-08-19 
2022-08-16 
2022-08-16 

addWorkDays(employmentStartDate, -5)

2022-08-02 
2022-08-01 
2022-08-03 

addWorkDays(employmentStartDate, 0)

2022-08-10 
2022-08-06 
2022-08-07 

L'esempio seguente calcola il bonus totale proporzionale da versare a ciascun dipendente per 2 anni in base al numero di giorni effettivamente lavorati da ciascun dipendente.

last_day_of_work = addWorkDays(employment_start_date, 730)
total_days_worked = netWorkDays(employment_start_date, last_day_of_work)
total_bonus = total_days_worked * bonus_per_day