tformatter 0.0.6

A package for formatting dates, currency, and other values.

TFormatters

Un package Flutter/Dart puissant pour le formatage, la validation, et la manipulation des données courantes telles que les dates, les heures, les devises, les numéros de téléphone, et bien plus.

Caractéristiques Principales Formatage des dates, heures, et durées. Formatage des montants et pourcentages. Validation des e-mails, URL, numéros de téléphone, et mots de passe sécurisés. Manipulation avancée des chaînes : génération d'initiales, extraction d'extensions, et plus encore. Génération et validation d'identifiants uniques.

1. Formatage des Dates et Heures

import 'package:tformatter/tformatter.dart';

void main() {
final now = DateTime.now();

// Formatage de la date
print(TFormatters.formatDate(now, pattern: 'dd/MM/yyyy', locale: 'fr_FR'));
// Résultat : 04/01/2025

// Formatage de l'heure
print(TFormatters.formatHour(now));
// Résultat : 14:30:15
}```

 2. Formatage des Montants et Pourcentages

```dart
void main() {
// Formatage d'un montant avec devise
print(TFormatters.formatCurrency(1234.56, locale: 'fr_FR', currencySymbol: '€'));
// Résultat : 1 234,56 €

// Formatage en pourcentage
print(TFormatters.formatPercentage(0.875));
// Résultat : 87.50%
}```

 3. Validation des Entrées
```dart
void main() {
// Validation d'une adresse e-mail
print(TFormatters.isValidEmail('[e-mail]'));
// Résultat : true

// Validation d'une URL
print(TFormatters.isValidUrl('https://example.com'));
// Résultat : true

// Validation d'un mot de passe sécurisé
print(TFormatters.isValidPassword('StrongP@ss1'));
// Résultat : true
}```

 4. Manipulation des Chaînes
```dart
void main() {
// Génération d'initiales
print(TFormatters.generateInitials('John Doe'));
// Résultat : JD

// Extraction du domaine d'une adresse e-mail
print(TFormatters.extractEmailDomain('[e-mail]'));
// Résultat : example.com

// Extraction de l'extension d'un fichier
print(TFormatters.getFileExtension('document.pdf'));
// Résultat : pdf
}```

5. Gestion des Durées
```dart
void main() {
final duration = Duration(hours: 2, minutes: 30);

// Conversion d'une durée en texte lisible
print(TFormatters.durationToReadableText(duration));
// Résultat : 2 heures 30 minutes
}```

6. Fonctionnalités Diverses
```dart
void main() {
// Masquage de données sensibles
print(TFormatters.maskSensitiveData('1234567890', visibleChars: 4));
// Résultat : **\*\***7890

// Formatage d'une taille de fichier
print(TFormatters.formatFileSize(1048576));
// Résultat : 1.0 MB

}```

7. Formatage Direct dans les Champs de Texte


Le package inclut des **`TextInputFormatters`** pour ajouter des masquages ou formatages dynamiques directement dans les champs de texte.

#### Exemple : Formatter pour les devises

```dart
import 'package:tformatters/input_formatters/currency_input_formatter.dart';

TextFormField(
  inputFormatters: [
    CurrencyInputFormatter(locale: 'fr_FR', currencySymbol: '€'),
  ],
  decoration: const InputDecoration(
    labelText: 'Montant',
  ),
  keyboardType: TextInputType.number,
);
```
#### Exemple : Masquage de texte
```dart
import 'package:tformatters/input_formatters/masked_text_input_formatter.dart';

TextFormField(
  inputFormatters: [
    MaskedTextInputFormatter(mask: '####-####-####', separator: '-'),
  ],
  decoration: const InputDecoration(
    labelText: 'Numéro de carte',
  ),
  keyboardType: TextInputType.number,
);```



Liste Complète des Méthodes
Formatage
formatDate(DateTime date, {String pattern, String locale})
formatHour(DateTime date)
formatCurrency(double amount, {String locale, String currencySymbol})
formatPercentage(double value, {int decimalPlaces})
durationToReadableText(Duration duration)
Validation
isValidEmail(String email)
isValidUrl(String url)
isValidPhoneNumber(String phoneNumber)
isValidPassword(String password, {int minLength})
Manipulation
generateInitials(String fullName)
maskSensitiveData(String data, {int visibleChars})
extractEmailDomain(String email)
getFileExtension(String fileName)
toHyperlink(String text, String url)
generatePassword({int number})