Module sintra_5_58_0_0-sintra.datas
Manipulação de datas.
Functions
| split (data) | Extrai as partes da data (dia, mês e ano) |
| ma2periodo (mes, ano) | Calcula o período letivo a partir do ano e do mês dados. |
| data2periodo (data) | Calcula o período letivo em que uma data está inserida. |
| periodos_passados (data) | Retorna quantos períodos passaram desde a data até hoje. |
| periodo_corrente () | Calcula o período letivo do dia de hoje. |
| ano_semestre2periodo (a, s) | Monta uma string com o período letivo padronizado a partir de um ano (YY) e semestre. |
| periodo2ano_semestre (periodo) | Separa o ano e o semestre do período letivo. |
| periodo2inicio_fim (periodo) | Calcula as datas de início e fim do período letivo. |
| periodo_matricula (mat) | Calcula o período inicial da matrícula dada. |
| periodo_anterior (periodo, s) | Calcula o período letivo anterior ao período dado. |
| periodo_seguinte (periodo, s) | Calcula o período letivo seguinte ao período dado. |
| dmy2ymd (data) | Transforma uma string com uma data no formato brasileiro (D/M/Y) para o formato ANSI (Y-M-D). |
| dmy2time (data, day_offset) | Converte uma data no número de segundos que representa a data. |
| inicio_dia (data) | Converte uma data para o número de segundos que representa o início do dia. |
| fim_dia (data) | Converte uma data para o número de segundos que representa o final do dia. |
| ainda_nao_chegou (data) | Verifica se uma data ainda não chegou. |
| ainda_nao_passou (data) | Verifica se uma data ainda não passou. |
| ja_passou (data) | Verifica se uma data já passou. |
| ja_chegou (data) | Verifica se uma data já chegou. |
| lista_periodos (inicial, final) | Lista os períodos letivos a partir (e incluindo) de um dado período. |
| lista_periodos_fmt (inicial, final) | Lista os períodos letivos a partir de um dado período (incluído). |
| valida (dt) | Valida uma data, retornanda-a formatada. |
| formata (dt) | Formata a data, aceitando também sequência de algarismos. |
| por_extenso (dt) | Formata a data por extenso. |
Functions
- split (data)
-
Extrai as partes da data (dia, mês e ano)
Parameters:
- data String com a data no formato dd/mm/aaaa ou no formato aaaa/mm/dd ou 8 algarismos.
Returns:
- String com o dia.
- String com o mês.
- String com o ano.
- ma2periodo (mes, ano)
-
Calcula o período letivo a partir do ano e do mês dados.
Parameters:
- mes String com o mês.
- ano String com o ano.
Returns:
-
String com o período letivo no formato aaaa.s (onde 's' pode ser 1 ou 2).
- data2periodo (data)
-
Calcula o período letivo em que uma data está inserida.
Parameters:
- data String com a data no formato dd/mm/aaaa ou no formato aaaa/mm/dd.
Returns:
-
String com o período letivo no formato aaaa.s (onde 's' pode ser 1 ou 2).
- periodos_passados (data)
-
Retorna quantos períodos passaram desde a data até hoje.
Parameters:
- data String com uma data no formato dd/mm/aaaa ou no formato aaaa/mm/dd.
Returns:
-
Número com a quantidade de períodos passados desde a data até hoje.
- periodo_corrente ()
-
Calcula o período letivo do dia de hoje.
Leva em consideração que o segundo período do ano sempre termina no final
de fevereiro e que o primeiro período começa em março.
Returns:
-
String com o período letivo corrente, na forma YYYY.S (ano.semestre).
- ano_semestre2periodo (a, s)
-
Monta uma string com o período letivo padronizado a partir de um ano (YY)
e semestre.
Parameters:
- a String com o ano com dois algarismos.
- s String com o semestre.
Returns:
-
String com o período letivo no formato YYYY.S
- periodo2ano_semestre (periodo)
-
Separa o ano e o semestre do período letivo.
Parameters:
- periodo String com o período letivo (aceita "2015.1", "20151" ou 20151).
Returns:
- String com o ano.
- String com o semestre.
- periodo2inicio_fim (periodo)
-
Calcula as datas de início e fim do período letivo.
Parameters:
- periodo String com o período letivo (aceita "2015.1", "20151" ou 20151).
Returns:
- String com a data inicial.
- String com a data final.
- periodo_matricula (mat)
-
Calcula o período inicial da matrícula dada.
Parameters:
- mat String com a matrícula de um aluno.
Returns:
-
String com o período inicial da matrícula.
- periodo_anterior (periodo, s)
-
Calcula o período letivo anterior ao período dado.
Parameters:
- periodo String ou número com o período (aceita '2015.1', '20151' ou 20151) ou o ano.
- s String ou número com o semestre (aceita '1' ou '; o resto será considerado como segundo semestre).
Returns:
-
String com o período letivo anterior ao dado, na forma YYYY.S (ano.semestre).
- periodo_seguinte (periodo, s)
-
Calcula o período letivo seguinte ao período dado.
Parameters:
- periodo String ou número com o período (aceita '2015.1', '20151' ou 20151) ou o ano.
- s String ou número com o semestre (opcional; aceita '1' e qualquer outra coisa é considerada como segundo semestre).
Returns:
-
String com o período letivo seguinte ao dado, na forma YYYY.S (ano.semestre).
- dmy2ymd (data)
-
Transforma uma string com uma data no formato brasileiro (D/M/Y) para o
formato ANSI (Y-M-D).
Parameters:
- data String com a data (separadores válidos: / - .)
Returns:
-
String com a data no formato YYYY-MM-DD.
- dmy2time (data, day_offset)
-
Converte uma data no número de segundos que representa a data.
Parameters:
- data String com a data (separadores válidos: / - .)
- day_offset Número a ser somado ao dia (usa-se 0 para considerar o início do dia e 1 para considerar o fim do dia).
Returns:
-
Número de segundos que representa a data.
- inicio_dia (data)
-
Converte uma data para o número de segundos que representa o início do dia.
Parameters:
- data String com a data (separadores válidos: / - .)
Returns:
-
Número de segundos que representa o início do dia da data.
- fim_dia (data)
-
Converte uma data para o número de segundos que representa o final do dia.
Parameters:
- data String com a data (separadores válidos: / - .)
Returns:
-
Número de segundos que representa o final do dia da data.
- ainda_nao_chegou (data)
-
Verifica se uma data ainda não chegou. Se for o próprio dia, o resultado
é false.
Parameters:
- data String com a data (separadores válidos: / - .)
Returns:
-
Booleano indicando se a data já passou.
- ainda_nao_passou (data)
-
Verifica se uma data ainda não passou. Se for o próprio dia, o resultado
é true.
Parameters:
- data String com a data (separadores válidos: / - .)
Returns:
-
Booleano indicando se a data já passou.
- ja_passou (data)
-
Verifica se uma data já passou. Se for o próprio dia, o resultado é false.
Parameters:
- data String com a data (separadores válidos: / - .)
Returns:
-
Booleano indicando se a data já passou.
- ja_chegou (data)
-
Verifica se uma data já chegou. Se for o próprio dia, o resultado é true.
Parameters:
- data String com a data (separadores válidos: / - .)
Returns:
-
Booleano indicando se a data já passou.
- lista_periodos (inicial, final)
-
Lista os períodos letivos a partir (e incluindo) de um dado período.
Parameters:
- inicial String ou Número do período inicial
- final String ou Número do período final (default = período corrente)
Returns:
-
Iterador que retorna números (retorna 20101 para o período 2010.1)
- lista_periodos_fmt (inicial, final)
-
Lista os períodos letivos a partir de um dado período (incluído).
Parameters:
- inicial String ou Número do período inicial
- final String ou Número do período final (default = período corrente)
Returns:
-
Iterador que retorna strings com os períodos no formato XXXX.X
- valida (dt)
-
Valida uma data, retornanda-a formatada.
Parameters:
- dt String com a data em DMY.
Returns:
- Booleano indicando se a data é válida.
- String com a data formatada (DD/MM/YYYY), caso seja válida.
- formata (dt)
-
Formata a data, aceitando também sequência de algarismos.
Parameters:
- dt String com a data (em DMY ou YMD ou 8 algarismos).
Returns:
- String com a data formatada (DD/MM/YYYY) ou nil, em caso de erro.
- String com mensagem de erro, se houver.
- por_extenso (dt)
-
Formata a data por extenso.
Parameters:
- dt String com a data (em DMY ou YMD ou 8 algarismos).
Returns:
- String com a data formatada (DD de NOME_MES de YYYY) ou nil, em caso de erro.
- String com mensagem de erro, se houver.