Histórico da Página

...

• Função H: Retorna o número de horas em formato String ( em minutos ).

Sintaxe: H (HORA) Tipo de Retorno: String Exemplo: H (':00') Resultado da fórmula = 480

• Função HADNOT: Retorna o número de horas ou vezes trabalhadas no período de adicional noturno ( 22:00 às 05:00) no período de datas determinado. (0 – horas, 1- total de dias).

Sintaxe: HADNOT: (DATA, DATA, STRING) Tipo de Retorno: Valor Exemplo: 1- HADNOT ('01/05/1999', '31/05/1999' , '0') Desse modo, o sistema irá retornar o número de horas de adicional noturno no período. 2- HADNOT ('01/05/1999', '31/05/1999' , '1') Desse modo, o sistema irá retornar o número de dias de adicional noturno no período.

• Função HOJE: Retorna a data do dia de hoje.

Sintaxe: HOJE Tipo de Retorno: Data

• Função HORARIOCODDIA: Retorna o código do horário do funcionário em uma data.

Sintaxe: HORARIOCODDIA (DATA) Tipo de Retorno: String Exemplo: HORARIOCODDIA ('06/01/2002') Resultado da fórmula = 0001

• Função HORARIODIA: Retorna as batidas do horário do funcionário em uma data.

Sintaxe: HORARIODIA (DATA) Tipo de Retorno: String Exemplo: HORARIODIA ('06/11/2000') = 22:00E 22:59S 23:59E Observação: A função de fórmula HORARIODIA não verifica a situação do funcionário antes de retornar o horário a ser trabalhado. Caso o funcionário se encontre Afastado, Demitido ou de Férias a variável retornará o horário do funcionário para o dia pesquisado. Exemplo: Horário do Funcionário: 12:00 às 18:00 Período de férias: 17/03/2003 à 16/04/2003 HORARIODIA('12/03/2003') Resultado da fórmula = '12:00 - 18:00' HORARIODIA('18/03/2003') Resultado da fórmula = '12:00 - 18:00'

• Função HORARIODIAALTER: Retorna as batidas do horário do funcionário em uma data, considerando também o horário alternativo.

Sintaxe: HORARIODIAALTER (DATA) Tipo de Retorno: String Exemplo: HORARIODIAALTER ('15/01/2004') = 08:00E 12:00S 14:00E 18:00S Caso o funcionário tenha um horário alternativo e estiver utilizando o horário alternativo na data solicitada o sistema trará as batidas do horário alternativo e não as batidas do horário. Funcionário de chapa 00001 Horário – 08:00E 12:00S 14:00E 18:00S Horário alternativo – 15:00E 21:00S Batidas do funcionário: 28/01/2004 – 15:15E 21:37S Fórmula de cálculo: HORARIODIAALTER ('28/01/2004') Resultado da fórmula = 15:00E 21:00S Observação: A função de fórmula HORARIODIAALTER não verifica a situação do funcionário antes de retornar o horário a ser trabalhado. Caso o funcionário se encontre Afastado, Demitido ou de Férias a variável retornará o horário do funcionário para o dia pesquisado. Exemplo: Horário do Funcionário: 12:00 às 18:00 Período de férias: 17/03/2003 à 16/04/2003 HORARIODIAALTER('12/03/2003') Resultado da fórmula = '12:00 - 18:00' HORARIODIAALTER('18/03/2003') Resultado da fórmula = '12:00 - 18:00'

• Função HORARIODIASIT: Retorna o horário do funcionário em uma data verificando a situação do funcionário.

Sintaxe: HORARIODIASIT(DATA) Tipo de Retorno: String Exemplo: HORARIODIASIT ('06/11/2000') Resultado da fórmula = 22:00E 22:59S 23:59E Observação: A função de fórmula HORARIODIASIT verifica a situação do funcionário antes de retornar o horário a ser trabalhado. Caso o funcionário se encontre Afastado, Demitido ou de Férias a variável retornará vazio para o dia pesquisado. Exemplo: Horário do Funcionário: 12:00 às 18:00 Período de férias: 17/03/2003 à 16/04/2003 HORARIODIA('12/03/2003') Resultado da fórmula = '12:00 - 18:00' HORARIODIA('18/03/2003') Resultado da fórmula = ' '

• Função HORARIOIND: Retorna o horário do funcionário em um índice específico.
• Sintaxe: HORARIODIA (ÍNDICE DO HORÁRIO) Tipo de Retorno: String Exemplo: Horário do funcionário X: Índice Horário 1 22:00E 2 01:00S 02:00E 05:00S 22:00E 3 01:00S 02:00E 05:00S 22:00E 4 01:00S 02:00E 05:00S 22:00E 5 01:00S 02:00E 05:00S 22:00E 6 01:00S 02:00E 05:00S 7 DESC(00:00 - 24:00) Teste da fórmula HORARIOIND (5) Resultado da fórmula = 01:00S 02:00E 05:00S 22:00E
• Função HORARIOMAISDIATRAB: Retorna o código do horário que o funcionário mais trabalhou em um intervalo de datas.

Sintaxe: HORARIOMAISDIATRAB (DATA, DATA) Tipo de Retorno: String Exemplo: HORARIOMAISDIATRAB (IPM , FPM) Resultado da fórmula = 00016

• Função HORARIOTURNODIA: Verifica se no dia o funcionário está fazendo horário de turno de revezamento.

Sintaxe: HORARIOTURNODIA (DATA) Tipo de Retorno: Valor No cadastro de horário do funcionário existe um campo chamado "Horário com turno de revezamento", esta função irá verificar no histórico de horário do funcionário se na data escolhida o funcionário estará trabalhando ou não em um horário que esteja com este campo marcado. Se for verdade o sistema retornará 1 (um), se for falso o sistema retornará 0 (zero). Exemplos:1) Verificar se no dia 06/01/2002 o funcionário está trabalhando em um horário de turno de revezamento. HORARIOTURNODIA ('06/01/2002') Resultado da fórmula = 1 2) Contar quantos dias do período atual o funcionário trabalhará no horário de turno de revezamento. DECL DT, CONT; SETVAR (DT, IPM); REPITA SE HORARIOTURNODIA (DT) > 0 ENTAO SETVAR (CONT, CONT+1) FIMSE; SETVAR (DT, DT+1) ATE (DT=FPM+1); CONT Teste da fórmula = 16

• Função HORASABONO: Retorna o número de horas (em minutos) de abono em um determinado dia.

Sintaxe: HORASABONO (DATA) Tipo de Retorno: Valor Exemplo: HORASABONO ('/11/2000') Resultado da fórmula = 480

• Função HORASABONOADNOT: Retorna o número de horas (em minutos) de abono dia a dia durante o período de adicional noturno.

Sintaxe: HORASABONOADNOT (DATA, DATA) Tipo de Retorno: Valor Exemplo: Horário do funcionário: 22:00E 05:00S Adicional Noturno: 22:00 às 05:00 Batidas do funcionário: 02/08/2004 - 23:00E 03/08/2004 - 04:00S HORASABONOADNOT ('/08/2004', '/08/2004'). Desse modo, o sistema irá retornar 120 horas de abono do Adicional Noturno.

• Função HORASABONOJOR: Retorna as horas (em minutos) de abono por jornada. Poderão ser definidos os abonos de Atrasos ('), Faltas (') ou Ambos ('')

Sintaxe: HORASABONOJOR (DATA, DATA, STRING). Tipo de Retorno: Valor Exemplo: O sistema irá verificar quantas horas de abono o funcionário teve no dia. No dia 26/07/2004 foi cadastrado um abono de falta para o funcionário. Horário do funcionário: 22:00E 05:00S HORASABONOJOR ('/07/2004', '/07/2004', ') Desse modo, o sistema irá retornar 420 horas de abono no dia. Observação: Sempre será considerada a jornada que inicia no dia analisado.

• Função HORASABONOPORABONO: Retorna o número de horas que um abono foi utilizado em uma data ou período determinado.

Sintaxe: HORASABONOPORABONO (DATA , DATA , STRING , STRING) Tipo de Retorno: Valor 1ª Data = Data do início do período desejado. 2ª Data = Data do fim do período desejado. 1ª String: A – retornar as horas de atrasos abonadas. F – retornar as horas de faltas abonadas. ''– retornar as horas de faltas e atrasos abonadas. 2ª String: Informar o código do abono desejado informado no menu Cadastros |Cálculos | Abonos. Exemplo: HORASABONOPORABONO('21/02/2006' , '20/03/2006' , 'A' , '0004') Resultado = 120

• Função HORASADNOT: Retorna o número de horas (em minutos ) de adicional noturno do funcionário em uma determinada data.

Sintaxe: HORASADNOT (DATA) Tipo de Retorno: Valor Exemplos: Batidas do funcionário X: Data: 06/11/2000 22:00E 08/11/2000 01:00S 02:00E 05:00S 22:00E 1) HORASADNOT ( '/11/2000') Resultado da fórmula = 120 2)HORASADNOT ( '/11/2000') Resultado da fórmula = 240

• Função HORASAFAST: Retorna o número de horas ( em minutos ) de afastamento ou número de dias de afastamento em um período (0 – Horas, 1 – Total de Dias) .

Sintaxe: HORASAFAST (DATA, DATA, STRING) Tipo de Retorno: Valor Exemplos: 1 - HORASAFAST ( '/01/2004', '/02/2004', 0) Desse modo, o sistema irá retornar o número de horas (em minutos) do afastamento de um período. 2 - HORASAFAST ( '/01/2004', '/02/2004', 1) Desse modo, o sistema irá retornar o número de dias de afastamento de um período.

• Função HORASATRASO: Retorna o número de horas ( em minutos ) de atraso do funcionário em uma determinada data.

Sintaxe: HORASATRASO (DATA) Tipo de Retorno: Valor Exemplo: Horário do funcionário X: Data: 01/11/2000 08:00E 12:00S 14:00E 18:00S Batidas do funcionário X: 01/11/2000 10:00E 12:00S 14:00E 18:00S Resultado da fórmula: HORASATRASO ( '/11/2000')=120

• Função HORASATRPERTOT: Retorna o número de horas totais( em minutos ) de atrasos do funcionário em um determinado período.

Sintaxe: HORASATRPERTOT (DATA, STRING, DATA, STRING) Tipo de Retorno: Valor Exemplo: HORASATRPERTOT (IPM , '00:01' , FPM , '08:00') A função irá retornar as horas de atraso (em minutos) no intervalo de 00:01 às 08:00 horas de cada dia do início do período mensal até o fim do período mensal.

• Função HORASBASE: Retorna o número de horas ( em minutos ) base do funcionário em uma determinada data.

Sintaxe: HORASBASE (DATA) Tipo de Retorno: Valor Exemplo: Horário do funcionário X: Data: 12/06/2000 08:00E 12:00S 14:00E 18:00S Resultado da fórmula: HORASBASE ( '/06/2000') Resultado da fórmula = 480

• Função HORASFALTA: Retorna o número de horas ( em minutos ) de falta do funcionário em uma determinada data.

Sintaxe: HORASFALTA (DATA) Tipo de Retorno: Valor Exemplo: Horário do funcionário X: Data: 17/01/2000 08:00E 12:00S 14:00E 18:00S Batidas do funcionário X: 17/01/2000 O funcionário não teve batidas neste dia. Resultado da fórmula: HORASFALTA ( '/01/2000') Resultado da fórmula = 480

• Função HORASFALTAJOR: Retorna o número de horas ( em minutos ) de falta de acordo com a jornada do horário do funcionário em uma determinada data.

Sintaxe: HORASFALTAJOR (DATA) Tipo de Retorno: Valor Exemplo: Horário do funcionário X: Data: 17/01/2004 - 22:00E 18/01/2004 - 05:00S Batidas do funcionário X: 17/01/2004 O funcionário não teve batidas neste dia. 18/01/2004 O funcionário não teve batidas neste dia. Resultado da fórmula: HORASFALTAJOR ( '/01/2004') Resultado da fórmula = 420 HORASFALTAJOR ( '/01/2004') Resultado da fórmula = 0 Observação: Neste caso o sistema vai considerar as horas de falta apenas para o dia 17/01/2004, pois é o dia do início da jornada do horário do funcionário. O resultado de 420 minutos equivale a 07:00 horas dos intervalos de 22:00 às 24:00 do dia 17/01/2004 e 00:00 às 05:00 do dia 18/01/2004.

• Função HORASTRAB: Retorna o número de horas ( em minutos ) trabalhadas pelo funcionário em uma determinada data.

Sintaxe: HORASTRAB (DATA) Tipo de Retorno: Valor Exemplo: Batidas do funcionário X: Data: 17/01/2000 08:00E 12:00S 14:00E 18:00S 18/01/2000 O funcionário não teve batidas neste dia. 20/01/2000 08:00E 12:00S Teste da fórmula: HORASTRAB ( '/01/2000') Resultado da fórmula = 480 HORASTRAB ( '/01/2000') Resultado da fórmula = 0 HORASTRAB ( '/01/2000') Resultado da fórmula = 240

• Função HORASTRABDESC: Retorna o número de horas ( em minutos ) trabalhadas em dia de descanso ou feriado pelo funcionário.

Sintaxe: HORASTRABDESC (DATA, STRING) Tipo de Retorno: Valor Observação: No campo String deverão ser passados os seguintes valores: '0' - Retornará as horas trabalhadas considerando descanso, grupo de descanso e feriado; '1' - Retornará as horas trabalhadas considerando descansos e grupo de descanso; '2' - Retornará as horas trabalhadas considerando feriados. ''- Retornará as horas trabalhadas considerando apenas os descansos do Grupo de Descanso. Exemplo: Feriado no dia 30/03/2007 funcionário trabalhou 08:00 neste dia. HORASTRABDESC ( '30/03/2007' , '2' ) Resultado da fórmula = 480

• Função HORASTRABJOR: Retorna o número de horas ( em minutos ) trabalhadas pelo funcionário por jornada em uma determinada data.

Sintaxe: HORASTRABJOR (DATA) Tipo de Retorno: Valor Exemplo: Batidas do funcionário X: Data: 17/01/2003 22:00E 18/01/2003 05:00S Teste da fórmula: HORASTRABJOR ( '/01/2003') Resultado da fórmula = 420

• Função HORASTRABPER: Retorna o número de horas ( em minutos ) trabalhadas pelo funcionário em um determinado período.

Sintaxe: HORASTRABPER (DATA, STRING, DATA, STRING) Tipo de Retorno: Valor Exemplo: HORASTRABPER: ('01/02/1999', ':00', '01/03/1999', ':00'), A função irá retornar as horas trabalhadas pelo funcionário do dia 01/02 a partir das 22:00 até o dia 01/03 às 5:00.

• Função HORASTRABPERTOT: Retorna o número de horas totais( em minutos ) trabalhadas pelo funcionário em um determinado período.

Sintaxe: HORASTRABPERTOT (DATA, STRING, DATA, STRING) Tipo de Retorno: Data Exemplo: HORASTRABPERTOT (IPM , '00:01' , FPM , '08:00') A função irá retornar as horas trabalhadas (em minutos) no intervalo de 00:01 às 08:00 horas de cada dia do início do período mensal até o fim do período mensal.

• Função HORCOMPDIA: Retorna os intervalos de compensação cadastrados em uma data.

Sintaxe: HORCOMPDIA (DATA) Tipo de Retorno: String Exemplo: HORCOMPDIA ( '/11/2000') Resultado da fórmula = COMP(00:00 - 24:00)

• Função HORDESCDIA: Retorna os intervalos de descanso cadastrados em uma data.

Sintaxe: HORDESCDIA (DATA) Tipo de Retorno: String Exemplo: HORDESCDIA ( '/11/2000') Resultado da fórmula = DESC(00:00 - 24:00)

• Função HORDESCDIAGRUPO: Retorna os Intervalos de descanso em uma data.

Sintaxe: HORDESCDIAGRUPO (DATA,STRING) Tipo de Retorno: String O campo STRING poderá ser preenchido com: '0' - Retorna o intervalo do descanso considerando somente o horário do funcionário. '1' - Retorna o intervalo do descanso considerando o horário e o grupo de descanso associado ao funcionário. O descanso do grupo de descanso tem prioridade sobre o descanso do horário. '2' - Retorna o intervalo do descanso considerando somente o grupo de descanso associado ao funcionário Exemplo: HORDESCDIAGRUPO ( '/09/2005', 0) Resultado da fórmula = DESC(00:00 - 24:00)

• Função HORIREFDIA: Retorna os intervalos de refeição cadastrados em uma data.

Sintaxe: HORIREFDIA (DATA) Tipo de Retorno: String Exemplo: HORIREFDIA ( '/01/2000') Resultado da fórmula = IREF(12:00 - 14:00)

• Função HORNORMDIA: Retorna as batidas do horário cadastrado em uma data.

Sintaxe: HORNORMDIA (DATA) Tipo de Retorno: String Exemplo: HORNORMDIA ( '/01/2000') Resultado da fórmula = 08:00E 12:00S 14:00E 18:00S

...

Funções Específicas do TOTVS Automação de Ponto