RetHorPrvTrb

Calcula a quantidade de horas previstas de trabalho dentro do período informado. Considera as batidas do cadastro de horário do colaborador. Se for informado o parâmetro Data de Verificação, calcula a quantidade de horas previstas de trabalho apenas na data de verificação e dentro do período informado.

Sintaxe: RetHorPrvTrb(Numero NumEmp, Numero TipCol, Numero NumCad, Numero DatIni, Numero HorIni, Numero DatFim, Numero HorFim, Numero DatVer, Numero End xhorprv, Numero End xdiaint);

Parâmetros:

Nome	Tipo	Descrição
NumEmp	Numérico	Empresa do Colaborador.
TipCol	Numérico	Tipo do Colaborador.
NumCad	Numérico	Cadastro do Colaborador.
DatIni	Numérico	Data inicial do intervalo.
HorIni	Numérico	Hora inicial do intervalo.
DatFim	Numérico	Data final do intervalo.
HorFim	Numérico	Hora final do intervalo.
DatVer	Numérico	Data de Verificação das horas previstas de trabalho. Se informar 0, considera todo o período informado. Caso informar uma data, calcula apenas nesta data e dentro do período informado.
xhorprv	Numérico	Retorna as horas previstas de trabalho.
xdiaint	Numérico	Retorna 1 se horas previstas de trabalho no período corresponderem à jornada do dia inteiro. Utiliza-se apenas se informar uma data na variável DatVer. Se DatVer for igual a 0, xdiaint retornará sempre 0.

Exemplos: 

Retorna horas previstas na data para um colaborador com as seguintes batidas no cadastro do horário: 08:00 - 12:00 - 13:30 - 18:00

Exemplo 1: Período das 08:00 às 18:00 do mesmo dia.

A variável xhorprv retornará 510 minutos = 08:30 de trabalho previsto.
A variável xdiaint retornará 1, pois na data de verificação, o total de horas previstas de trabalho é igual ao total de horas do período.

Exemplo 2: Período das 13:30 às 18:00 do mesmo dia.

A variável xhorprv retornará 270 minutos = 04:30 de trabalho previsto dentro da data e do período informado.
A variável xdiaint retornará 0, pois na data de verificação, o total de horas previstas de trabalho (08:30) é diferente do total de horas na data e no período (04:30).

Exemplo 3: Período das 13:30hs às 18:00 do dia seguinte.

A variável xhorprv retornará 780 minutos = 13:00 (04:30 do primeiro dia + 08:30 do segundo dia) de trabalho previsto.
A variável xdiaint retornará 0, pois não se aplica quando a data de verificação está zerada.

Utilização: Regras de Apuração, Consistência de Acertos, Integração e Gerador de Relatórios.