TeixeiraSoftware.Finance.Currency
4.0.0
See the version list below for details.
dotnet add package TeixeiraSoftware.Finance.Currency --version 4.0.0
NuGet\Install-Package TeixeiraSoftware.Finance.Currency -Version 4.0.0
<PackageReference Include="TeixeiraSoftware.Finance.Currency" Version="4.0.0" />
paket add TeixeiraSoftware.Finance.Currency --version 4.0.0
#r "nuget: TeixeiraSoftware.Finance.Currency, 4.0.0"
// Install TeixeiraSoftware.Finance.Currency as a Cake Addin #addin nuget:?package=TeixeiraSoftware.Finance.Currency&version=4.0.0 // Install TeixeiraSoftware.Finance.Currency as a Cake Tool #tool nuget:?package=TeixeiraSoftware.Finance.Currency&version=4.0.0
TeixeiraSoftware.Finance.Currency
A simple cross platform currency class library for .Net, that follows the ISO 4217 standard.
The implementation of this library is compatible with .Net Standard 2.0 (see https://docs.microsoft.com/en-us/dotnet/standard/net-standard for details).
This package depends on TeixeiraSoftware.Finance.Money
Installation
Install through NuGet Package Manager:
Install-Package TeixeiraSoftware.Finance.Currency
Usage
First of all, import the namespace, for convenience:
using TeixeiraSoftware.Finance;
Instantiation
Then, you can get a currency instance by three different ways:
- Calling a factory property, where XXX is the three letters ISO code of the currency:
var currency = Currency.XXX;
- Using the ByAlphabeticCode method, where, again, XXX is the three letters ISO code of the currency:
var currency = Currency.ByAlphabeticCode("XXX");
- Using the ByNumericCode method, where 999 is the three numbers ISO code of the currency:
// Note that the numeric code is a string
var currency = Currency.ByNumericCode("999");
Properties
The Currency class have four read only properties:
public struct Currency
{
// The ISO name of the currency
public string Name { get; }
// The 3 letters ISO code of the currency
public string AlphabeticCode { get; }
// The numeric ISO code of the currency
public string NumericCode { get; }
// The ISO minor units of the currency
public byte MinorUnits { get; }
}
Comparing currencies
The available comparison operators are ==
and !=
. The .Equals
method is available also.
// returns true
var areCurrenciesEquivalent = (Currency.XXX == Currency.XXX);
// returns false
var areCurrenciesEquivalent = (Currency.XXX != Currency.XXX);
Listing all the currencies
You can use the Currency.AllCurrencies
property to get a list of all the currencies:
var allCurrencies = Currency.AllCurrencies;
foreach (var currency in allCurrencies)
{
var currencyName = currency.Name;
var currencyISOAlphabeticCode = currency.AlphabeticCode;
var currencyISONumericCode = currency.NumericCode;
var currencyMinorUnits = currency.MinorUnits;
}
Contributing
I'm currently looking for help to improve the project. You can see some topics that you can help with in the issues section of the project's GitHub page. You can also contribute by doing unit tests, documentation, making pull requests or sharing the project.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- TeixeiraSoftware.Finance.Money (>= 4.0.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
First release.