<!--
{
  "availability" : [
    "iOS: 16.0.0 -",
    "iPadOS: 16.0.0 -",
    "macCatalyst: 16.0.0 -",
    "macOS: 13.0.0 -",
    "tvOS: 16.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 9.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Foundation",
  "identifier" : "/documentation/Foundation/Locale/Currency-swift.struct",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Foundation"
    ],
    "preciseIdentifier" : "s:10Foundation6LocaleV8CurrencyV"
  },
  "title" : "Locale.Currency"
}
-->

# Locale.Currency

A type that represents the currency system used by a locale, like dollars or euros.

```
struct Currency
```

## Topics

### Creating a currency instance

[`init(String)`](/documentation/Foundation/Locale/Currency-swift.struct/init(_:))

Creates a currency instance from a BCP 47 identifier.

[`init(stringLiteral: String)`](/documentation/Foundation/Locale/Currency-swift.struct/init(stringLiteral:))

Creates a currency instance from a BCP 47 identifier as a string literal.

### Examining currency properties

[`var identifier: String`](/documentation/Foundation/Locale/Currency-swift.struct/identifier)

The currency’s identifier.

[`var isISOCurrency: Bool`](/documentation/Foundation/Locale/Currency-swift.struct/isISOCurrency)

A Boolean value that indicates whether the currency is in the list of ISO-defined currencies.

### Using common currencies

[`static var isoCurrencies: [Locale.Currency]`](/documentation/Foundation/Locale/Currency-swift.struct/isoCurrencies)

An array containing currencies defined by the currency codes in ISO-4217.

[`static let unknown: Locale.Currency`](/documentation/Foundation/Locale/Currency-swift.struct/unknown)

A representation of an “unknown” currency, for use with transactions that don’t involve any currency.

## Relationships

### Conforms To

[`Hashable`](/documentation/Swift/Hashable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`ExpressibleByExtendedGraphemeClusterLiteral`](/documentation/Swift/ExpressibleByExtendedGraphemeClusterLiteral)

[`Decodable`](/documentation/Swift/Decodable)

[`Sendable`](/documentation/Swift/Sendable)

[`Copyable`](/documentation/Swift/Copyable)

[`Encodable`](/documentation/Swift/Encodable)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`Equatable`](/documentation/Swift/Equatable)

[`ExpressibleByUnicodeScalarLiteral`](/documentation/Swift/ExpressibleByUnicodeScalarLiteral)

[`Escapable`](/documentation/Swift/Escapable)

[`ExpressibleByStringLiteral`](/documentation/Swift/ExpressibleByStringLiteral)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)