Skip to content

Commit 688a098

Browse files
rubensdemelorubensdemelo
committed
Merge remote-tracking branch 'origin/main'
# Conflicts: # README.md # example/pubspec.lock # lib/brasil_datetime.dart # test/brasil_datetime_test.dart
2 parents afe9406 + bd5b7a0 commit 688a098

File tree

4 files changed

+551
-168
lines changed

4 files changed

+551
-168
lines changed

‎README.md‎

Lines changed: 86 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,32 @@
1+
# brasil_datetime 🇧🇷
12

2-
# brasil_datetime
3-
4-
Extensões para a classe `DateTime` para facilitar a formatação em pt_BR 🇧🇷.
5-
6-
![Codecov](https://img.shields.io/codecov/c/github/flutterbootcamp/brasil_datetime)
3+
Extensões para a classe `DateTime` que facilitam a formatação de data e hora para o padrão brasileiro (pt_BR).
74

85
[![Dart](https://github.com/flutterbootcamp/brasil_datetime/actions/workflows/dart.yml/badge.svg)](https://github.com/flutterbootcamp/brasil_datetime/actions/workflows/dart.yml)
6+
[![Codecov](https://img.shields.io/codecov/c/github/flutterbootcamp/brasil_datetime)](https://codecov.io/gh/flutterbootcamp/brasil_datetime)
97

10-
## Apresentação
8+
## Visão Geral
119

12-
Este package facilita a manipulação de objetos `DateTime` de acordo com o padrão e formato brasileiro.
10+
Este pacote oferece um conjunto de extensões para a classe `DateTime` do Dart, permitindo a formatação de datas e horas de maneira simples e intuitiva, seguindo as convenções brasileiras.
1311

1412
## Instalação
1513

14+
Adicione `brasil_datetime` ao seu arquivo `pubspec.yaml`:
15+
1616
```yaml
1717
dependencies:
1818
brasil_datetime: ^0.4.0
1919
```
2020
21-
## Extensões
21+
Em seguida, importe o pacote em seu código Dart:
22+
23+
```dart
24+
import 'package:brasil_datetime/brasil_datetime.dart';
25+
```
26+
27+
## Como Usar
2228

23-
Para qualquer objeto `DateTime`, as extensões abaixo estão disponíveis:
29+
As extensões estão disponíveis diretamente em qualquer objeto `DateTime`.
2430

2531
```dart
2632
// objeto de exemplo
@@ -60,10 +66,80 @@ data.minuto(); // 37
6066
data.segundo(); // 6
6167
data.minutoSegundo(); // 37:06
6268
```
69+
70+
## Como Usar
71+
72+
As extensões estão disponíveis diretamente em qualquer objeto `DateTime`.
73+
74+
```dart
75+
void main() {
76+
final agora = DateTime.now();
77+
78+
// Exemplo de uso
79+
print('Data completa: ${agora.diaMesAno()}'); // Saída: 25/10/2023
80+
print('Dia por extenso: ${agora.diaSemana()}'); // Saída: quarta-feira
81+
print('Mês por extenso: ${agora.mesExt()}'); // Saída: outubro
82+
}
83+
```
84+
85+
## Extensões Disponíveis
86+
87+
Abaixo estão todas as extensões disponíveis para formatação.
88+
89+
### Data
90+
91+
| Método | Descrição | Exemplo (para `DateTime(1987, 4, 22)`) |
92+
| --------------------- | ------------------------------------------------- | -------------------------------------- |
93+
| `dia()` | Dia do mês | `22` |
94+
| `diaSemana()` | Nome do dia da semana | `quarta-feira` |
95+
| `diaSemanaAbrev()` | Nome abreviado do dia da semana | `qua.` |
96+
| `mes()` | Nome do mês | `abril` |
97+
| `mesAbrev()` | Nome abreviado do mês | `abr.` |
98+
| `mesNoAno()` | Número do mês no ano | `4` |
99+
| `diaMes()` | Dia e mês (`dd/MM`) | `22/04` |
100+
| `diaMesAbrev()` | Dia e mês abreviado (`dd 'de' MMM`) | `22 de abr.` |
101+
| `diaSemanaEMes()` | Dia da semana e mês (`EEE, dd/MM`) | `qua., 22/04` |
102+
| `diaMesExt()` | Dia e mês por extenso (`d 'de' MMMM`) | `22 de abril` |
103+
| `diaSemanaMesExt()` | Dia da semana e mês por extenso | `quarta-feira, 22 de abril` |
104+
| `trimestreAbrev()` | Trimestre abreviado (`T1`, `T2`, etc.) | `T2` |
105+
| `trimestre()` | Trimestre por extenso | `2º trimestre` |
106+
| `ano()` | Ano (`yyyy`) | `1987` |
107+
| `anoMes()` | Mês e ano (`MM/yyyy`) | `04/1987` |
108+
| `diaMesAno()` | Data completa (`dd/MM/yyyy`) | `22/04/1987` |
109+
| `semanaDiaMesAnoAbrev()`| Data com dia da semana abreviado | `qua., 22/04/1987` |
110+
| `mesAnoAbrev()` | Mês abreviado e ano (`MMM 'de' yyyy`) | `abr. de 1987` |
111+
| `diaMesAnoAbrev()` | Data com mês abreviado | `22 de abr. de 1987` |
112+
| `semanaDiaMesAnoExtAbrev()`| Data com dia e mês abreviados | `qua., 22 de abr. de 1987` |
113+
| `mesAnoExt()` | Mês por extenso e ano (`MMMM 'de' yyyy`) | `abril de 1987` |
114+
| `diaMesAnoExt()` | Data com mês por extenso | `22 de abril de 1987` |
115+
| `semanaDiaMesAnoExt()`| Data completa por extenso | `quarta-feira, 22 de abril de 1987` |
116+
| `trimestreAnoAbrev()` | Trimestre abreviado e ano (`QQQ 'de' yyyy`) | `T2 de 1987` |
117+
118+
### Hora
119+
120+
| Método | Descrição | Exemplo (para `DateTime(..., 23, 37, 06)`) |
121+
| ------------------- | ------------------------------------- | ------------------------------------------ |
122+
| `hora()` | Hora (`HH`) | `23` |
123+
| `horaMinuto()` | Hora e minuto (`HH:mm`) | `23:37` |
124+
| `horaMinutoSegundo()`| Hora, minuto e segundo (`HH:mm:ss`) | `23:37:06` |
125+
| `minuto()` | Minuto (`mm`) | `37` |
126+
| `segundo()` | Segundo (`ss`) | `06` |
127+
| `minutoSegundo()` | Minuto e segundo (`mm:ss`) | `37:06` |
128+
129+
### Data e Hora
130+
131+
| Método | Descrição | Exemplo (para `DateTime(1987, 4, 22, 23, 37)`) |
132+
| ---------------------- | --------------------------------------- | ---------------------------------------------- |
133+
| `diaMesAnoHoraMinuto()`| Data e hora (`dd/MM/yyyy HH:mm`) | `22/04/1987 23:37` |
134+
63135
---
64136

137+
## Contribuidores
138+
139+
Agradecemos a todos que contribuíram para este projeto!
140+
65141
<a href="https://github.com/flutterbootcamp/brasil_datetime/graphs/contributors">
66142
<img src="https://contrib.rocks/image?repo=flutterbootcamp/brasil_datetime" />
67143
</a>
68144

69-
Made with [contrib.rocks](https://contrib.rocks).
145+
Feito com [contrib.rocks](https://contrib.rocks).

0 commit comments

Comments
 (0)