Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
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 esempioparseDate
,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
decimalToInt
abs
, 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
![Data table showing employee bonus calculations with fields for ID, dates, days worked, and bonus amounts.](images/addWorkDays-function-example.png)