tformatter 0.0.5

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. Installation Ajoutez le package à votre projet Flutter/Dart via pub.dev :

flutter pub add tformatters

dependencies: tformatters: ^0.0.4

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

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**

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**

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**

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**

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


TextFormField(
  inputFormatters: [
    CurrencyInputFormatter(locale: 'fr_FR', currencySymbol: '€'),
  ],
  decoration: const InputDecoration(
    labelText: 'Montant',
  ),
  keyboardType: TextInputType.number,
);

#### Exemple : Masquage de texte

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})