ColonesExchangeRate 2.0.2

dotnet add package ColonesExchangeRate --version 2.0.2
NuGet\Install-Package ColonesExchangeRate -Version 2.0.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ColonesExchangeRate" Version="2.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ColonesExchangeRate --version 2.0.2
#r "nuget: ColonesExchangeRate, 2.0.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install ColonesExchangeRate as a Cake Addin
#addin nuget:?package=ColonesExchangeRate&version=2.0.2

// Install ColonesExchangeRate as a Cake Tool
#tool nuget:?package=ColonesExchangeRate&version=2.0.2

Colones Exchange Rate NuGet & npm Packages

This repository contains a NuGet & npm packages to provide currency conversion from Colones (Costa Rica - CRC ₡) to Dollars (United States - USD $) and Euros (European Union - EUR €). It consumes the API from Ministerio de Hacienda de Costa Rica (The API is in Spanish).

Note: The API usually changes the response for the Euro exchange rate, during business hours, the response contains the exchange rate in dollars and colones, but after business hours, the response only contains the exchange rate in dollars. The ColonesExchangeRate packages handles this situation and returns the correct values.

ColonesExchangeRate - CI/CD

alternate text is missing from this package README image

Installation

You can install the ColonesExchangeRate package from NuGet.org, npmjs.com or GitHub Packages.

NuGet Package

To install ColonesExchangeRate using NuGet, run the following command in the Package Manager Console:

Install-Package ColonesExchangeRate

Usage

To use ColonesExchangeRate, first create an instance of the class:

var converter = new ColonesExchangeRate();
var amount = 1000;

decimal dollarsToColones = await converter.DollarsToColones(amount);
decimal colonesToDollars = await converter.ColonesToDollars(amount);
decimal dollarsToEuros = await converter.DollarsToEuros(amount);
decimal eurosToDollars = await converter.EurosToDollars(amount);
decimal colonesToEuros = await converter.ColonesToEuros(amount);
decimal eurosToColones = await converter.EurosToColones(amount);
var dollarExchangeRate = await converter.GetDollarExchangeRate();
var euroExchangeRate = await converter.GetEuroExchangeRate();

Console.WriteLine($"{amount} Dollars = {dollarsToColones} Colones");
Console.WriteLine($"{amount} Colones = {colonesToDollars} Dollars");
Console.WriteLine($"{amount} Dollars = {dollarsToEuros} Euros");
Console.WriteLine($"{amount} Euros = {eurosToDollars} Dollars");
Console.WriteLine($"{amount} Colones = {colonesToEuros} Euros");
Console.WriteLine($"{amount} Euros = {eurosToColones} Colones");
    
Console.WriteLine($"Dollar exchange rate: {dollarExchangeRate.date} - Sale: {dollarExchangeRate.sale} - Purchase: {dollarExchangeRate.purchase}");
if (euroExchangeRate.colones != null)
    Console.WriteLine($"Euro exchange rate: {euroExchangeRate.date} - Dollars: {euroExchangeRate.dollars} - Colones: {euroExchangeRate.colones}");
else
    Console.WriteLine($"Euro exchange rate: {euroExchangeRate.date} - Dollars: {euroExchangeRate.dollars}");

The result will look similar to this: Console Result

Note: Replace amount with the amount of currency you want to convert.

The following methods return a tuple with three values:

  • GetDollarExchangeRate: the date of the exchange rate, the sale rate, and the purchase rate.
  • GetEuroExchangeRate: the date of the exchange rate, the dollars rate, and the colones rate.

npm Package

To install ColonesExchangeRate using npm, run the following command in the command line of your project's root directory:

npm i @dsanchezcr/colonesexchangerate

Usage

To use ColonesExchangeRate, first import the colonesexchangerate module:

import('@dsanchezcr/colonesexchangerate').then(module => {
     // Create a new instance of the class
    const exchangeRateClient = new module.default();
    // Use the methods of the class
    async function test() {
        try {
            const amount = 1000;
            const amountInColones = await exchangeRateClient.dollarsToColones(amount);
            console.log(`$${amount} is ₡${amountInColones}`);

            const amountInColonesToDollars = await exchangeRateClient.colonesToDollars(amount);
            console.log(`₡${amount} is $${amountInColonesToDollars}`);

            const amountInDollarsToEuros = await exchangeRateClient.dollarsToEuros(amount);
            console.log(`$${amount} is €${amountInDollarsToEuros}`);

            const amountInDollarsFromEuros = await exchangeRateClient.eurosToDollars(amount);
            console.log(`€${amount} is $${amountInDollarsFromEuros}`);

            const amountInColonesToEuros = await exchangeRateClient.colonesToEuros(amount);
            console.log(`₡${amount} is €${amountInColonesToEuros}`);

            const amountInEurosToColones = await exchangeRateClient.eurosToColones(amount);
            console.log(`€${amount} is ₡${amountInEurosToColones}`);

            const dollarExchangeRate = await exchangeRateClient.getDollarExchangeRate();
            console.log(`Dollar exchange rate: ${JSON.stringify(dollarExchangeRate)}`);

            const euroExchangeRate = await exchangeRateClient.getEuroExchangeRate();
            console.log(`Euro exchange rate: ${JSON.stringify(euroExchangeRate)}`);
        } catch (ex) {
            console.error(`Error: ${ex.message}`);
        }
    }
    test();
});

The result will look similar to this: npm console result

Note: Replace amount with the amount of currency you want to convert.

The following methods return a tuple with three values:

  • getDollarExchangeRate: the date of the exchange rate, the sale rate, and the purchase rate.
  • getEuroExchangeRate: the date of the exchange rate, the dollars rate, and the colones rate.

Contributing

Contributions are welcome! To contribute to ColonesExchangeRate, fork the repository and create a pull request with your changes.

License

ColonesExchangeRate is licensed under the MIT License. See the LICENSE file for details.

Product 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 netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.0.2 218 11/24/2023
2.0.1 104 11/20/2023
2.0.0 94 11/19/2023
1.0.2 100 11/18/2023
1.0.1 166 11/12/2023
1.0.0 117 11/6/2023