https://github.com/designliquido/delegua-tempo
Biblioteca para manejo de datas, horas, minutos, segundos e calendários para Delégua e JavaScript.
https://github.com/designliquido/delegua-tempo
delegua hacktoberfest portugues portuguese typescript
Last synced: 4 months ago
JSON representation
Biblioteca para manejo de datas, horas, minutos, segundos e calendários para Delégua e JavaScript.
- Host: GitHub
- URL: https://github.com/designliquido/delegua-tempo
- Owner: DesignLiquido
- License: mit
- Created: 2022-01-05T21:05:00.000Z (over 4 years ago)
- Default Branch: principal
- Last Pushed: 2026-03-29T19:15:12.000Z (4 months ago)
- Last Synced: 2026-03-29T21:21:03.172Z (4 months ago)
- Topics: delegua, hacktoberfest, portugues, portuguese, typescript
- Language: TypeScript
- Homepage:
- Size: 256 KB
- Stars: 4
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Biblioteca para manipulação de tempo para Delégua e JavaScript
Assim como Delégua é uma variação da linguagem Égua, esta biblioteca é uma variação da biblioteca `tempo` de Égua, com capacidades adicionais de manipulação de segundos, minutos, horas, dias, semanas, meses e anos.
Diferente de Égua, que possui a implementação da respectiva biblioteca de tempo como uma coleção de métodos internos, essa biblioteca é distribuída independentemente da linguagem Delégua. Isso possibilita importar a biblioteca tanto para Delégua quanto para JavaScript. Basta para isso instalar a biblioteca usando o NPM.
Além disso, [a solução Delégua (linguagem + bibliotecas)](https://github.com/DesignLiquido/delegua-completo) já inclui esta biblioteca. Para importar, basta usar:
```js
var tempo = importar('tempo')
```
## Arquitetura interna
`delegua-tempo` utiliza [Day.js](https://day.js.org) para implementação de recursos internos. O objeto de datas da Day.js é bem mais robusto que o objeto `Date` correspondente do JavaScript, com capacidades para trabalhar com fusos horários, conversão de datas, semanas, e assim por diante.
Esta biblioteca expõe um objeto especial chamado `ObjetoData`. Este objeto encapsula certas propriedades e funções de objetos da Day.js, e pode também ser utilizada para entender como fazer determinadas operações, principalmente em operações de data e usos com fusos horários.
## Modo de uso
Usando [a solução Delégua com todas as bibliotecas](https://github.com/DesignLiquido/delegua-completo), ou ainda usando [Delégua Web](https://designliquido.github.io/delegua-web), importe a biblioteca e use-a da seguinte forma:
```js
var tempo = importar('tempo')
var agora = tempo.agora()
escreva(agora) // Escreve algo como:
```
Neste exemplo, a variável `agora` é um objeto de data com as seguintes propriedades:
```js
escreva(agora.dia) // Escreve o dia na saída padrão
escreva(agora.mes) // Escreve o mês na saída padrão
escreva(agora.ano) // Escreve o ano na saída padrão
escreva(agora.hora) // Escreve a hora na saída padrão
escreva(agora.minuto) // Escreve o minuto na saída padrão
escreva(agora.segundo) // Escreve o segundo na saída padrão
escreva(agora.milissegundo) // Escreve o milissegundo na saída padrão
escreva(agora.diaDaSemana) // Escreve o dia da semana na saída padrão
escreva(agora.semanaDoAno) // Escreve a semana do ano na saída padrão
```