<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >setlocale</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="Manual do PHP" HREF="index.html"><LINK REL="UP" TITLE="String" HREF="ref.strings.html"><LINK REL="PREVIOUS" TITLE="rtrim" HREF="function.rtrim.html"><LINK REL="NEXT" TITLE="sha1_file" HREF="function.sha1-file.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=UTF-8"></HEAD ><BODY CLASS="refentry" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >Manual do PHP</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.rtrim.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.sha1-file.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.setlocale" ></A >setlocale</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN220352" ></A ><P > (PHP 3, PHP 4, PHP 5)</P >setlocale -- Define informações locais</DIV ><DIV CLASS="refsect1" ><A NAME="AEN220355" ></A ><H2 >Descrição</H2 >string <B CLASS="methodname" >setlocale</B > ( mixed category, string locale [, string ...] )<BR ></BR >string <B CLASS="methodname" >setlocale</B > ( mixed category, array locale )<BR ></BR ><P > <CODE CLASS="parameter" >Category</CODE > é uma constante (ou string) especificando a categoria de funções afetadas pela definição local: setting: <P ></P ><UL ><LI ><P > LC_ALL para tudo abaixo </P ></LI ><LI ><P > LC_COLLATE para comparação de strings, veja <A HREF="function.strcoll.html" ><B CLASS="function" >strcoll()</B ></A > </P ></LI ><LI ><P > LC_CTYPE para classificação de caracteres e conversão, por exemplo <A HREF="function.strtoupper.html" ><B CLASS="function" >strtoupper()</B ></A > </P ></LI ><LI ><P > LC_MONETARY para <A HREF="function.localeconv.html" ><B CLASS="function" >localeconv()</B ></A > </P ></LI ><LI ><P > LC_NUMERIC para o separador decimal (Veja também <A HREF="function.localeconv.html" ><B CLASS="function" >localeconv()</B ></A >) </P ></LI ><LI ><P > LC_TIME para formatação de data e hora com <A HREF="function.strftime.html" ><B CLASS="function" >strftime()</B ></A > </P ></LI ></UL > </P ><P > Se <CODE CLASS="parameter" >locale</CODE > for uma string vazia <TT CLASS="literal" >""</TT >, o nome do local será obtido apartir de variaveis de ambiente com os mesmos nomes das categorias acima ou apartir de "LANG". </P ><P > Se <CODE CLASS="parameter" >locale</CODE > for <TT CLASS="constant" ><B >NULL</B ></TT > ou <TT CLASS="literal" >"0"</TT >, a definição de local não é modificada, apenas retorna a definição atual. </P ><P > Se <CODE CLASS="parameter" >locale</CODE > for uma matriz ou conter parâmetros adicionais, então cada elemento da matriz é tentado como um local até obter sucesso. Isto é útil se um lugar é conhecido por nomes diferentes em sistemas diferentes ou para prover um outro local se um estiver indisponível. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Passar varios lugares não esta disponível antes do PHP 4.3.0 </P ></BLOCKQUOTE ></DIV ><P > <B CLASS="function" >setlocale()</B > retorna o novo local ou <TT CLASS="constant" ><B >FALSE</B ></TT > se a funcionalidade de locais não estiver implementada em sua plataforma, o local não existir ou a categoria for invalida. Uma categoria invalida também gera uma mensagem de aviso. Nomes de categoria/local podem ser encontrados em <A HREF="http://www.faqs.org/rfcs/rfc1766" TARGET="_top" >RFC 1766</A > e <A HREF="http://www.w3.org/WAI/ER/IG/ert/iso639.htm" TARGET="_top" >ISO 639</A >. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > O valor de retorno de <B CLASS="function" >setlocale()</B > depende do sistema no qual o PHP esta sendo executado. Ele retorna exatamente o que a função setlocale do sistema retorna. </P ></BLOCKQUOTE ></DIV ><DIV CLASS="tip" ><BLOCKQUOTE CLASS="tip" ><P ><B >Dica: </B > Usuários do windows encontraram informações úteis sobre as strings de <CODE CLASS="parameter" >locale</CODE > no site <ACRONYM CLASS="acronym" >MSDN</ACRONYM > da Microsoft. Strings das línguas suportadas podem ser encontradas <A HREF="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vclib/html/_crt_language_strings.asp" TARGET="_top" >aqui</A > as strings de pais/região suportados <A HREF="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vclib/html/_crt_country_strings.asp" TARGET="_top" > aqui</A >. Sistemas windows suportam códigos de três letras para pais/região especificados por <TT CLASS="literal" >ISO 3166-Alpha-3</TT >, que pode ser encontrada em <A HREF="http://www.unicode.org/onlinedat/countries.html" TARGET="_top" >Unicode website </A >. </P ></BLOCKQUOTE ></DIV ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN220426" ></A ><P ><B >Exemplo 1. Exemplos <B CLASS="function" >setlocale()</B ></B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /></font><font color="#FF8000">/* Define o local para Holandês(usar pt_BR para o Português(Brasil) ) */<br /></font><font color="#0000BB">setlocale </font><font color="#007700">(</font><font color="#0000BB">LC_ALL</font><font color="#007700">, </font><font color="#DD0000">'nl_NL'</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* Mostra: vrijdag 22 december 1978 */<br /></font><font color="#007700">echo </font><font color="#0000BB">strftime </font><font color="#007700">(</font><font color="#DD0000">"%A %e %B %Y"</font><font color="#007700">, </font><font color="#0000BB">mktime </font><font color="#007700">(</font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">12</font><font color="#007700">, </font><font color="#0000BB">22</font><font color="#007700">, </font><font color="#0000BB">1978</font><font color="#007700">));<br /><br /></font><font color="#FF8000">/* Tenta diferentes nomes de local para o Alemão apartir do PHP 4.3.0 */<br /></font><font color="#0000BB">$loc_de </font><font color="#007700">= </font><font color="#0000BB">setlocale </font><font color="#007700">(</font><font color="#0000BB">LC_ALL</font><font color="#007700">, </font><font color="#DD0000">'de_DE@euro'</font><font color="#007700">, </font><font color="#DD0000">'de_DE'</font><font color="#007700">, </font><font color="#DD0000">'de'</font><font color="#007700">, </font><font color="#DD0000">'ge'</font><font color="#007700">);<br />echo </font><font color="#DD0000">"Preferred locale for german on this system is '$loc_de'"</font><font color="#007700">;<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN220431" ></A ><P ><B >Exemplo 2. Exemplos para windows de<B CLASS="function" >setlocale()</B ></B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /></font><font color="#FF8000">/* Define o local para Holandês(usar ptb para o Português(Brasil) ) */<br /></font><font color="#0000BB">setlocale </font><font color="#007700">(</font><font color="#0000BB">LC_ALL</font><font color="#007700">, </font><font color="#DD0000">'nld_nld'</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* Mostra: vrijdag 22 december 1978 */<br /></font><font color="#007700">echo </font><font color="#0000BB">strftime </font><font color="#007700">(</font><font color="#DD0000">"%A %d %B %Y"</font><font color="#007700">, </font><font color="#0000BB">mktime </font><font color="#007700">(</font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">12</font><font color="#007700">, </font><font color="#0000BB">22</font><font color="#007700">, </font><font color="#0000BB">1978</font><font color="#007700">));<br /><br /></font><font color="#FF8000">/* Tenta diferentes nomes de local para o Alemão apartir do PHP 4.3.0 */<br /></font><font color="#0000BB">$loc_de </font><font color="#007700">= </font><font color="#0000BB">setlocale </font><font color="#007700">(</font><font color="#0000BB">LC_ALL</font><font color="#007700">, </font><font color="#DD0000">'de_DE@euro'</font><font color="#007700">, </font><font color="#DD0000">'de_DE'</font><font color="#007700">, </font><font color="#DD0000">'deu_deu'</font><font color="#007700">);<br />echo </font><font color="#DD0000">"Preferred locale for german on this system is '$loc_de'"</font><font color="#007700">;<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.rtrim.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Principal</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.sha1-file.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >rtrim</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.strings.html" ACCESSKEY="U" >Acima</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >sha1_file</TD ></TR ></TABLE ></DIV ></BODY ></HTML >