# firstworkdate – função de script e gráfico

A função firstworkdate retorna a última data inicial para obter o no\_of\_workdays (segunda-sexta) com término não posterior a end\_date, levando em conta os feriados opcionalmente listados. end\_date e holiday devem ser datas ou carimbos de data/hora válidos.

Sintaxe:

firstworkdate(end\_date, no\_of\_workdays [, holiday] )

**Tipo de dados de retorno:** inteiro

Argumentos:

Argumentos FirstWorkDate

| Argumento | Descrição |
| --- | --- |
| end\_date | Data/hora da data de término para avaliar. |
| no\_of\_workdays | Número de dias úteis para alcançar. |
| holiday | Períodos de feriados a serem excluídos dos dias de trabalho. Um período de feriado é declarado como uma data de início e uma data de término, separadas por virgulas.<br><br>Exemplo: `  '25/12/2013', '26/12/2013' `<br><br>Você pode excluir mais de um período de feriado, separados por virgulas.<br><br>Exemplo: `  '25/12/2013', '26/12/2013', '31/12/2013', '01/01/2014' ` |

Exemplos e resultados:

Esses exemplos usam o formato de data DD/MM/YYYY. O formato de data é especificado no comando SET DateFormat na parte superior do seu script de carregamento. Altere o formato nos exemplos para atender às suas necessidades.

Exemplo 1:

`firstworkdate ('29/12/2014', 9)`

Retorna '17/12/2014.

Exemplo 2:

`firstworkdate ('29/12/2014', 9, '25/12/2014', '26/12/2014')`

Retorna 15/12/2014, pois um feriado de dois dias é considerado.

Exemplo 3:

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.

`ProjectTable:` `LOAD *, recno() as InvID INLINE [` `EndDate` `28/03/2015` `10/12/2015` `5/2/2016` `31/3/2016` `19/5/2016` `15/9/2016` `] ;` `NrDays:` `Load *,` `FirstWorkDate(EndDate,120) As StartDate` `Resident ProjectTable;` `Drop table ProjectTable;`

` `

A tabela resultante mostra os valores retornados deFirstWorkDate para cada registro na tabela.

Resultados do exemplo 3

| InvID | EndDate | StartDate |
| --- | --- | --- |
| 1 | 28/03/2015 | 13/10/2014 |
| 2 | 10/12/2015 | 26/06/2015 |
| 3 | 5/2/2016 | 24/08/2015 |
| 4 | 31/3/2016 | 16/10/2015 |
| 5 | 19/5/2016 | 04/12/2015 |
| 6 | 15/9/2016 | 01/04/2016 |