| Constructor | Type | Description |
|---|---|---|
new Hbar(<amount>) | Hbar | Initializes the Hbar object |
new Hbar(<amount>)
HBAR from:
Construct HBAR from different representations.| Method | Type | Description |
|---|---|---|
Hbar.from(<hbars>) | long / BigDecimal | Returns an Hbar whose value is equal to the specified value |
Hbar.from(<hbars, unit>) | long / BigDecimal , HbarUnit | Returns an Hbar representing the value in the given units |
Hbar.fromString(<text>) | CharSequence | Converts the provided string into an amount of hbars |
Hbar.fromString(<text, unit>) | CharSequence, HbarUnit | Converts the provided string into an amount of hbars |
Hbar.fromTinybars(<tinybars>) | long | Returns an Hbar converted from the specified number of tinybars |
//10 HBAR
new Hbar(10);
//10 HBAR from hbar value
Hbar.from(10);
//100 tinybars from HBAR convert to unit
Hbar.from(100, HbarUnit.TINYBAR);
// 10 HBAR converted from string value
Hbar.fromString("10");
//100 tinybars from string value
Hbar.fromString("10", HbarUnit.TINYBAR);
// v2.0.0+
// 10 HBAR
new Hbar(10);
//10 HBAR
Hbar.from(10);
//100 tinybars
Hbar.from(100, HbarUnit.TINYBAR);
// 10 HBAR converted from string value
Hbar.fromString("10");
//100 tinybars from string value
Hbar.fromString("100", HbarUnit.TINYBAR);
//100 HBAR
hedera.NewHbar(10)
//100 tinybars
hedera.HbarFrom(10, hedera.HbarUnits.Tinybar)
// v2.0.0+
// 10 HBAR
Hbar::new(10);
// 10 HBAR from hbar value
Hbar::from(10);
// 100 tinybars from HBAR convert to unit
Hbar::from_tinybars(100);
// 10 HBAR converted from string value
Hbar::from_str("10")?;
// v0.34.0
HBAR to:
Convert HBAR to a different unit/format.| Method | Type | Description |
|---|---|---|
to(<unit>) | HbarUnit | Specify the unit of hbar to convert to. Use As for Go. |
toString(<unit>) | HbarUnit | String value of the hbar unit to convert to. Use String() for Go. |
toTinybars() | Long | Hbar value converted to tinybars |
//10 HBAR converted to tinybars
new Hbar(10).to(HbarUnit.TINYBAR);
//10 HBAR converted to tinybars
new Hbar(10).toString(HbarUnit.TINYBAR);
//10 HBAR converted to tinybars
new Hbar(10).toTinybars();
// v2.0.0+
//10 HBAR converted to tinybars
new Hbar(10).to(HbarUnit.TINYBAR);
//10 HBAR converted to tinybars
new Hbar(10).toString(HbarUnit.TINYBAR);
//10 HBAR converted to tinybars
new Hbar(10).toTinybars();
//10 HBAR converted to tinybars
hedera.NewHbar(10).As(hedera.HbarUnits.Tinybar)
//10 HBAR to string format
hedera.NewHbar(10).String()
//10 HBAR converted to tinybars
hedera.NewHbar(10).AsTinybar()
// v2.0.0+
// 10 HBAR converted to tinybars
Hbar::new(10).to(HbarUnit::Tinybar);
// 10 HBAR converted to tinybars
Hbar::new(10).to_tinybars();
// v0.34.0
HBAR constants:
Provided constant values of HBAR.| Method | Type | Description |
|---|---|---|
Hbar.MAX | Hbar | A constant value of the maximum number of hbars (50_000_000_000 hbars) |
Hbar.MIN | Hbar | A constant value of the minimum number of hbars (-50_000_000_000 hbars) |
Hbar.ZERO | Hbar | A constant value of zero hbars |
//The maximum number of hbars
Hbar hbarMax = Hbar.MAX;
//The minimum number of hbars
Hbar hbarMin = Hbar.MIN;
//A constant value of zero hbars
Hbar hbarZero = Hbar.ZERO;
// v2.0.0+
//The maximum number of hbars
const hbarMax = Hbar.MAX;
//The minimum number of hbars
const hbarMin = Hbar.MIN;
//A constant value of zero hbars
const hbarZero = Hbar.ZERO;
//The maximum number of hbars
hbarMax := hedera.MaxHbar
//The minimum number of hbars
hbarMin := hedera.MinHbar
//A constant value of zero hbars
hbarZero := hedera.ZeroHbar
// v2.0.0+
// The maximum number of hbars
let hbar_max = Hbar::MAX;
// The minimum number of hbars
let hbar_min = Hbar::MIN;
// A constant value of zero hbars
let hbar_zero = Hbar::ZERO;
// v0.34.0
HBAR units
Modify the HBAR representation to one of the HBAR denominations.| Function | Description |
|---|---|
HbarUnit.TINYBAR | The atomic (smallest) unit of hbar, used natively by the Hedera network |
HbarUnit.MICROBAR | Equivalent to 100 tinybar or 1⁄1,000,000 hbar. |
HbarUnit.MILLIBAR | Equivalent to 100,000 tinybar or 1⁄1,000 hbar |
HbarUnit.HBAR | The base unit of hbar, equivalent to 100 million tinybar. |
HbarUnit.KILOBAR | Equivalent to 1 thousand hbar or 100 billion tinybar.HbarUnit.Megabar |
HbarUnit.MEGABAR | Equivalent to 1 million hbar or 100 trillion tinybar. |
HbarUnit.GIGABAR | Equivalent to 1 billion hbar or 100 quadrillion tinybar. |
//100 tinybars
Hbar.from(100, HbarUnit.TINYBAR);
// v2.0.0+
//100 tinybars
Hbar.from(100, HbarUnit.TINYBAR);
// v2.0.0+
//100 tinybars
hedera.HbarFrom(100, hedera.HbarUnits.Tinybar)
// v2.0.0+
HBAR decimal places
HBAR is counted in tinybars (8 decimals) everywhere inside the network, including inside the EVM. Only the JSON-RPC relay uses 18 decimals, so that Ethereum wallets and libraries work unchanged.| Where the value appears | Decimals |
|---|---|
| Hedera API (HAPI) and SDKs | 8 (tinybars) |
Inside Solidity: msg.value, address.balance | 8 (tinybars) |
JSON-RPC wire: transaction value, eth_getBalance, eth_gasPrice | 18 (weibars, 1 tinybar = 10¹⁰ weibars) |
value by 10¹⁰ before the EVM runs, so a contract never sees the 18-decimal value. See HBAR decimal places for the full rules.