Java Currency getInstance()

🎓 Check Out My Top 25 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare

In this guide, you will learn about the Currency getInstance() method in Java programming and how to use it with an example.

1. Currency getInstance() Method Overview

Definition:

The getInstance() method of the Currency class in Java is a static method used to obtain a Currency instance representing the specified currency code or Locale. 

The method throws IllegalArgumentException if the currency code is not a supported ISO 4217 code or the specified Locale doesn’t have a country.

Syntax:

1. public static Currency getInstance(String currencyCode)
2. public static Currency getInstance(Locale locale)

Parameters:

- currencyCode: a String representing the desired currency.

- locale: the locale for which a Currency instance is needed.

Key Points:

- The Currency class is part of the java.util package.

- The getInstance() method comes in two overloaded forms; one takes a string representing the currency code, and the other takes a Locale object.

- The method returns a Currency instance.

- An IllegalArgumentException is thrown if the currency code is invalid or the Locale doesn’t have a country.

2. Currency getInstance() Method Example

import java.util.Currency;
import java.util.Locale;

public class CurrencyGetInstanceExample {
    public static void main(String[] args) {
        // Getting Currency instance using currency code
        Currency usdCurrency = Currency.getInstance("USD");
        System.out.println("Currency Code: " + usdCurrency.getCurrencyCode());

        // Getting Currency instance using Locale
        Locale japanLocale = Locale.JAPAN; // Locale for Japan
        Currency jpyCurrency = Currency.getInstance(japanLocale);
        System.out.println("Currency Code for Japan: " + jpyCurrency.getCurrencyCode());

        // Attempting to get Currency instance using an invalid currency code
        try {
            Currency invalidCurrency = Currency.getInstance("INVALID");
        } catch (IllegalArgumentException e) {
            System.out.println("IllegalArgumentException: " + e.getMessage());
        }
    }
}

Output:

Currency Code: USD
Currency Code for Japan: JPY
IllegalArgumentException: Invalid ISO 4217 currency code INVALID

Explanation:

In this example, we first used the getInstance() method with a currency code ("USD") to obtain a Currency instance for the US Dollar and printed its currency code. 

Next, we created a Locale instance for Japan and used it to obtain a Currency instance for Japanese Yen, printing its currency code. Finally, we tried obtaining a Currency instance using an invalid currency code, which resulted in an IllegalArgumentException.

My Top and Bestseller Udemy Courses. The sale is going on with a 70 - 80% discount. The discount coupon has been added to each course below:

Build REST APIs with Spring Boot 4, Spring Security 7, and JWT

🆕 High-Demand 80–90% OFF

[NEW] Learn Apache Maven with IntelliJ IDEA and Java 25

🆕 High-Demand 80–90% OFF

ChatGPT + Generative AI + Prompt Engineering for Beginners

🚀 Trending Now 80–90% OFF

Spring 7 and Spring Boot 4 for Beginners (Includes 8 Projects)

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Real-Time REST APIs with Spring Boot - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Microservices with Spring Boot and Spring Cloud

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Java Full-Stack Developer Course with Spring Boot and React JS

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Build 5 Spring Boot Projects with Java: Line-by-Line Coding

🌟 Top Rated 80–90% OFF

Testing Spring Boot Application with JUnit and Mockito

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot Thymeleaf Real-Time Web Application - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Master Spring Data JPA with Hibernate

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot + Apache Kafka Course - The Practical Guide

🎓 Student Favorite 80–90% OFF
Available in Udemy for Business

Java Testing: Mastering JUnit 5 Framework

🆕 New 80–90% OFF

Reactive Programming in Java: Spring WebFlux and Testing

🌟 Top Rated 80–90% OFF

Spring Boot + RabbitMQ Course - The Practical Guide

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Functional Programming in Java (Includes Java Collections)

🎓 Student Favorite 80–90% OFF

ChatGPT for Java Developers: Boost Your Productivity with AI

🚀 Trending Now 80–90% OFF