laravel intl formatter herunterladen - laravel intl formatter Quellcode herunterladen

laravel intl formatter

Dies ist eine Laravel-Portierung des Twig Intl Extension-Pakets.

Das Paket kann in jeder Laravel-basierten Anwendung verwendet werden, um die Internationalisierung schnell zu bewältigen, indem Hilfsfunktionen in Blade-Vorlagen oder der Laravel-Codebasis bereitgestellt werden.

Systemanforderungen

Laravel 8 und/oder 9
Symfony Intl-Komponente

Installation

Composer verwenden:

 composer require bakame/laravel-intl-formatter

Konfiguration

Um die Standardkonfiguration zu bearbeiten, müssen Sie die Paketkonfiguration in Ihrem Anwendungskonfigurationsverzeichnis veröffentlichen:

php artisan vendor:publish --provider= " BakameLaravelIntl " --tag=config

Die Konfigurationsdatei wird unter config/bakame-intl-formatter.php in Ihrem Anwendungsverzeichnis veröffentlicht.

Eine Übersicht über die verfügbaren Optionen finden Sie in der Konfigurationsdatei.

Dokumentation

Nach der Installation stellt das Paket die folgenden globalen Hilfsfunktionen bereit:

Ländername

Gibt den Ländernamen mit seinem aus zwei bzw. fünf Buchstaben bestehenden Code zurück;

country name: {{ country_name ( $country , $locale ) } }

 echo view ( $ templatePath , [ ' country ' => ' FR ' , ' locale ' => ' NL ' ])-> render ();
// country name: Frankrijk

Währungsname

Gibt den Währungsnamen anhand seines dreibuchstabigen Codes zurück;

currency name: {{ currency_name ( $currency , $locale ) } }

 echo view ( $ templatePath , [ ' currency ' => ' JPY ' , ' locale ' => ' PT ' ])-> render ();
// currency name: Iene japonês

Währungssymbol

Gibt das Währungssymbol anhand seines dreibuchstabigen Codes zurück;

currency symbol: {{ currency_symbol ( $currency , $locale ) } }

 echo view ( $ templatePath , [ ' currency ' => ' JPY ' , ' locale ' => ' PT ' ])-> render ();
// currency symbol: JP¥

Sprachname

Gibt das Währungssymbol anhand seines dreibuchstabigen Codes zurück;

language name: {{ language_name ( $language , $locale ) } }

 echo view ( $ templatePath , [ ' language ' => ' it ' , ' locale ' => ' nl ' ])-> render ();
// language name: Italiaans

Gebietsschemaname

Gibt das Währungssymbol anhand seines dreibuchstabigen Codes zurück;

locale name: {{ locale_name ( $data , $locale ) } }

 echo view ( $ templatePath , [ ' data ' => ' sw ' , ' locale ' => ' nl ' ])-> render ();
// locale name: Swahili

Name der Zeitzone

Gibt den Zeitzonennamen anhand seiner Kennung zurück;

timezone name: {{ locale_name ( $data , $locale ) } }

 echo view ( $ templatePath , [ ' timezone ' => ' Asia/Tokyo ' , ' locale ' => ' es ' ])-> render ();
// timezone name: hora de Japón (Tokio)

Länderzeitzonen

Gibt die Zeitzonenkennungen des angegebenen Ländercodes zurück;

country timezones: {{ implde ( " , " , country_timezones ( $country )) } }

 $ content = view ( $ templatePath , [ ' country ' => ' CD ' , ' locale ' => ' es ' ])-> render ();
echo $ content , PHP_EOL ; // country timezones: Africa/Kinshasa, Africa/Lubumbashi

Währung formatieren

Formatiert eine Zahl als Währung;

format currency: {{ format_currency ( $amount , $currency , $attrs , $locale ) } }

 $ templateData = [
    ' amount ' => 100.356 , 
    ' currency ' => ' USD ' , 
    ' locale ' => ' ES ' , 
    ' attrs ' => [
        ' fraction_digit ' => 1 ,
        ' rounding_mode ' => ' floor ' ,
    ]
];
echo view ( $ templatePath , $ templateData )-> render ();
// format currency: 100,3 US$

Nummer formatieren

Formatiert eine Zahl;

format number: {{ format_number ( $number , $locale , $attrs ) } }

 $ templateData = [
    ' number ' => 100.356 , 
    ' locale ' => ' nl ' , 
    ' style ' => ' spellout ' ,
    ' type ' => ' double ' ,
    ' attrs ' => [
        ' fraction_digit ' => 1 ,
        ' rounding_mode ' => ' floor ' ,
    ]
];
echo view ( $ templatePath , $ templateData )-> render ();
// format number: honderd komma drie

Datum/Uhrzeit formatieren

Formatiert ein Datum und eine Uhrzeit;

format datetime: {{ format_datetime ( $date , $locale , $timezone , $dateFormat , $timeFormat , $pattern , $calendar ) } }

 $ templateData = [
    ' date ' => ' yesterday ' , 
    ' dateFormat ' => ' full ' , 
    ' timeFormat ' => ' full ' , 
    ' pattern ' => '' ,
    ' timezone ' => ' Africa/Lubumbashi ' , 
    ' calendar ' => ' gregorian ' ,
    ' locale ' => ' sw ' ,
];
echo view ( $ templatePath , $ templateData )-> render ();
// format datetime: Alhamisi, 2 Juni 2022 00:00:00 Saa za Afrika ya Kati

Datum formatieren

Formatiert den Datumsteil einer Datums-/Uhrzeitangabe;

format date: {{ format_date ( $date , $locale , $timezone , $dateFormat , $pattern , $calendar ) } }

 $ templateData = [
    ' date ' => ' yesterday ' , 
    ' dateFormat ' => ' long ' , 
    ' pattern ' => '' ,
    ' timezone ' => ' Africa/Lubumbashi ' , 
    ' calendar ' => ' gregorian ' ,
    ' locale ' => ' sw ' ,
];
echo view ( $ templatePath , $ templateData )-> render ();
// format date: 2 Juni 2022

Zeit formatieren

Formatiert den Zeitteil einer Datums-/Uhrzeitangabe;

format time: {{ format_time ( $date , $locale , $timezone , $timeFormat , $pattern , $calendar ) } }

 $ templateData = [
    ' date ' => ' yesterday ' , 
    ' dateFormat ' => ' full ' , 
    ' pattern ' => '' ,
    ' timezone ' => ' Africa/Lubumbashi ' , 
    ' calendar ' => ' gregorian ' ,
    ' locale ' => ' sw ' ,
];
echo view ( $ templatePath , $ templateData )-> render ();
// format time: 00:00:00 Saa za Afrika ya Kati

Jede Funktion verwendet dieselben Argumente in derselben Reihenfolge wie die Filter/Funktionen des Twig Extra-Pakets.

Lokale Spezifikation

Wenn in Funktionsaufrufen kein locale angegeben ist, verwendet die Funktion das Ergebnis von IlluminateSupportFacadesApp::currentLocale() als zu verwendenden Gebietsschemawert.

Funktionen Signatur

In PHP8+ können Sie benannte Parameter verwenden, um die Verwendung von Funktionen zu verbessern, da diese in der Regel viele Argumente haben:

In PHP7.4

 <?php

echo format_datetime ( ' 2019-08-07 23:39:12 ' , ' fr ' , null , medium', ' medium ' , '' , ' gregorian ' , ' fr ' );

In PHP8+

 <?php

echo format_datetime (date: ' 2019-08-07 23:39:12 ' , locale: ' fr ' );

Mitwirken

Beiträge sind willkommen und werden voll angerechnet. Weitere Informationen finden Sie unter BEITRAGEN und VERHALTENSKODEX.

Testen

Die Bibliothek:

verfügt über eine PHPUnit-Testsuite
verfügt über eine Suite zum Testen der Codierungsstil-Compliance mit PHP CS Fixer.
verfügt über eine Code-Analyse-Compliance-Testsuite mit PHPStan.

Um die Tests auszuführen, führen Sie den folgenden Befehl im Projektordner aus.