# SetLocale

Sets the current request-level locale.

## Method Signature

```
SetLocale(locale=[string])
```

### Arguments

| Argument | Type     | Required | Description                                    | Default |
| -------- | -------- | -------- | ---------------------------------------------- | ------- |
| `locale` | `string` | `true`   | The locale ISO directive, common name or alias |         |

## Examples

### Set Locale Script Example

Outputs the current locale, Sets the locale to French (Belgian) and outputs it, then puts it back to the original and outputs it

```java
<bx:script>
	currentLocale = getLocale();
	writeOutput( "Current: " );
	writeDump( currentLocale );
	writeOutput( "<br />" );
	setLocale( "French (Belgian)" );
	writeOutput( "New: " );
	writeDump( getLocale() );
	writeOutput( "<br />" );
	setLocale( currentLocale );
	writeOutput( "Original: " );
	writeDump( getLocale() );
</bx:script>

```

### Additional Examples

```java
dump( getLocale() );
setLocale( "english (australian)" );
dump( getLocale() );
dump( Server.BOXLANG.SUPPORTEDLOCALES.listToArray().sort( "text" ) );

```

## Related

* [ClearLocale](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/i18n/clearlocale)
* [CurrencyFormat](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/i18n/currencyformat)
* [GetLocale](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/i18n/getlocale)
* [GetLocaleDisplayName](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/i18n/getlocaledisplayname)
* [GetLocaleInfo](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/i18n/getlocaleinfo)
* [IsCurrency](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/i18n/iscurrency)
* [LSCurrencyFormat](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/i18n/lscurrencyformat)
* [LSIsCurrency](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/i18n/lsiscurrency)
* [LSParseCurrency](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/i18n/lsparsecurrency)
* [ParseCurrency](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/i18n/parsecurrency)