java.math.BigDecimal.valueOf(long val) is an inbuilt method in Java that translates a long value into a BigDecimal value with a scale of zero. It allows us, the reuse of frequently used BigDecimal values and hence this “static factory method” is provided in preference to a (long) constructor. Package view is as follows:
--> java.math Package
--> BigDecimal Class
--> valueOf() Method
There are 3 types of variations in valueOf() method of BigDecimal class that are as depicted in syntax below via differing in parameters that are as follows:
- public static BigDecimal valueOf(long val)
- public static BigDecimal valueOf(double d)
- public static BigDecimal value(long l, int x)
Type 1: java.math.BigDecimal.valueOf(long val)
Parameters: The method accepts a single parameter val of Long data type and refers to the value that needs to be translated into a BigDecimal value.
Return value: The method returns a BigDecimal value of Long val.
Example:
Java
// Java Program to Illustrate valueOf() Method// of BigDecimal Class// Over long As Arguments // Importing required classesimport java.math.*; // Classpublic class GFG { // Main driver method public static void main(String[] args) { // Creating and declaring long value by // creating object of Long class Long ln = new Long("745812345678"); // Assigning above long value to BigDecimal BigDecimal b = BigDecimal.valueOf(ln); // Printing the BigDecimal value on console System.out.println( "The Converted BigDecimal value is: " + b); }} |
Output:
Type 2: java.math.BigDecimal.valueOf(double val)
The java.math.BigDecimal.valueOf(double val) is an inbuilt method in java that translates a double into a BigDecimal, using the double’s canonical string representation provided by the Double.toString(double) method.
Syntax:
public static BigDecimal valueOf(double val)
Parameters: The method accepts a single parameter val of Double data type and refers to the value that needs to be translated into a BigDecimal value.
Return value: The method returns a BigDecimal value which is equal to or approximately equal to Double val.
Example:
Java
// Java Program to Illustrate valueOf() Method// of BigDecimal Class// Over Double type As Arguments // Importing required classesimport java.math.*; // Classpublic class GFG { // Main driver method public static void main(String[] args) { // Creating a Double Object Double d = new Double("785.254"); /// Assigning the bigdecimal value of d to b BigDecimal b = BigDecimal.valueOf(d); // Printing BigDecimal value on console System.out.println( "The Converted BigDecimal value is: " + b); }} |
Output:
Type 3: java.math.BigDecimal.valueOf(long unscaledVal, int scale)
The java.math.BigDecimal.valueOf(long unscaledVal, int scale) is an inbuilt method in Java that is used to translate a long unscaled value and an int scale into a BigDecimal. This “static factory method” is provided in preference to a (long, int) constructor because it allows for reuse of frequently used BigDecimal values.
Syntax:
public static BigDecimal valueOf(long unscaledVal, int scale)
Parameters: It takes two parameters:
- unscaledVal: This is of Long data type and refers to the Unscaled value of the BigDecimal.
- scale: This is of Integer data type and refers to the Scale of the BigDecimal.
Return Value: A big decimal whose value is unscaled*10-scale.
Example:
Java
// Java Program to Illustrate valueOf() Method// of BigDecimal Class// Over (long, int) As Arguments // Importing required classesimport java.math.*; // Classpublic class GFG { // Main driver method public static void main(String[] args) { // Creating a Long Object by // creating object of Long class type Long ln = new Long("789654"); // Assigning the bigdecimal value to // BigDecimal with scale 3 BigDecimal b = BigDecimal.valueOf(ln, 3); // Printing BigDecimal value on console System.out.println("The BigDecimal value is " + b); }} |
Output:
