Download laravel intl formatter - download do código-fonte laravel intl formatter

laravel intl formatter

Esta é uma porta Laravel do pacote Twig Intl Extension.

O pacote pode ser usado em qualquer aplicativo baseado em Laravel para lidar rapidamente com a internacionalização, fornecendo funções auxiliares em modelos Blade ou base de código Laravel.

Requisitos do sistema

Laravel 8 e/ou 9
Componente Symfony Internacional

Instalação

Usar compositor:

 composer require bakame/laravel-intl-formatter

Configuração

Para editar a configuração padrão você precisa publicar a configuração do pacote no diretório de configuração do seu aplicativo:

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

O arquivo de configuração será publicado em config/bakame-intl-formatter.php no diretório do seu aplicativo.

Consulte o arquivo de configuração para uma visão geral das opções disponíveis.

Documentação

Depois de instalado, o pacote fornece as seguintes funções auxiliares globais:

Nome do país

Retorna o nome do país de acordo com seu código de duas/cinco letras;

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

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

Nome da moeda

Retorna o nome da moeda dado seu código de três letras;

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

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

Símbolo monetário

Retorna o símbolo da moeda dado seu código de três letras;

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

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

Nome do idioma

Retorna o símbolo da moeda dado seu código de três letras;

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

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

Nome da localidade

Retorna o símbolo da moeda dado seu código de três letras;

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

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

Nome do fuso horário

Retorna o nome do fuso horário de acordo com seu identificador;

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

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

Fusos horários do país

Retorna os identificadores de fuso horário do código do país fornecido;

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

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

Formatar moeda

Formata um número como moeda;

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$

Número de formato

Formata um número;

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

Formatar DataHora

Formata uma data e hora;

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

Formatar data

Formata a parte da data de um datetime;

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

Formatar hora

Formata a parte da hora de um datetime;

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

Cada função usa os mesmos argumentos na mesma ordem que os filtros/funções do pacote Twig Extra.

Especificação de localidade

Se nenhuma locale for especificada nas chamadas de função, a função usará o resultado de IlluminateSupportFacadesApp::currentLocale() como o valor de localidade a ser usado.

assinatura de funções

No PHP8+, você pode usar parâmetros nomeados para melhorar o uso de funções, pois elas tendem a ter muitos argumentos:

Em PHP7.4

 <?php

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

Em PHP8+

 <?php

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

Contribuindo

As contribuições são bem-vindas e serão totalmente creditadas. Consulte CONTRIBUIÇÃO e CÓDIGO DE CONDUTA para obter detalhes.

Teste

A biblioteca:

tem um conjunto de testes PHPUnit
tem um conjunto de testes de conformidade de estilo de codificação usando PHP CS Fixer.
possui um conjunto de testes de conformidade de análise de código usando PHPStan.

Para executar os testes, execute o seguinte comando na pasta do projeto.