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.

<div class="Code"><p>RetHorPrvTrb(R034FUN.NumEmp, R034FUN.TipCol, R034FUN.NumCad, DatPro, 480, DatPro, 1080, DatPro, xhorprv, xdiaint);</p></div>

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.

<div class="Code"><p>RetHorPrvTrb(R034FUN.NumEmp, R034FUN.TipCol, R034FUN.NumCad, DatPro, 810, DatPro, 1080, DatPro, xhorprv, xdiaint);</p></div>

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.

<div class="Code"><p>RetHorPrvTrb(R034FUN.NumEmp, R034FUN.TipCol, R034FUN.NumCad, DatPro, 810, DatPro+1, 1080, 0, xhorprv, xdiaint);</p></div>

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.

Este artigo ajudou você?