Python Pandas - Return the nanoseconds from Timedelta object using string input

To return the nanoseconds from Timedelta object, use the timedelta.nanoseconds property. The nanoseconds property extracts only the nanosecond component from a Timedelta object ?

Understanding Pandas Timedelta

TimeDeltas in Pandas represent differences in times and support various time units including nanoseconds. You can create Timedelta objects using string input with specific units ?

import pandas as pd

# Create a Timedelta object with nanoseconds
timedelta = pd.Timedelta('10 min 40 ns')

# Display the Timedelta
print("Timedelta:")
print(timedelta)

Timedelta:
0 days 00:10:00.000000040

Extracting Nanoseconds

The nanoseconds property returns only the nanosecond component of the Timedelta object ?

import pandas as pd

# Create a Timedelta object with nanoseconds
timedelta = pd.Timedelta('10 min 40 ns')

# Extract nanoseconds value
nanoseconds = timedelta.nanoseconds

print("Timedelta:", timedelta)
print("Nanoseconds component:", nanoseconds)

Timedelta: 0 days 00:10:00.000000040
Nanoseconds component: 40

Multiple Examples

Here are different ways to create Timedelta objects with nanoseconds ?

import pandas as pd

# Different Timedelta examples with nanoseconds
td1 = pd.Timedelta('5 hours 30 minutes 200 ns')
td2 = pd.Timedelta('1 day 500 ns')
td3 = pd.Timedelta('999 ns')

print("Examples of nanoseconds extraction:")
print(f"TD1: {td1} ? Nanoseconds: {td1.nanoseconds}")
print(f"TD2: {td2} ? Nanoseconds: {td2.nanoseconds}")
print(f"TD3: {td3} ? Nanoseconds: {td3.nanoseconds}")

Examples of nanoseconds extraction:
TD1: 0 days 05:30:00.000000200 ? Nanoseconds: 200
TD2: 1 days 00:00:00.000000500 ? Nanoseconds: 500
TD3: 0 days 00:00:00.000000999 ? Nanoseconds: 999

Key Points

The nanoseconds property returns an integer value between 0 and 999, representing only the nanosecond component. It does not include microseconds, seconds, or other time units ?

import pandas as pd

# Demonstrate nanoseconds range
td = pd.Timedelta('1 second 999 nanoseconds')

print("Full Timedelta:", td)
print("Nanoseconds only:", td.nanoseconds)
print("Total nanoseconds:", td.value)  # Total time in nanoseconds

Full Timedelta: 0 days 00:00:01.000000999
Nanoseconds only: 999
Total nanoseconds: 1000000999

Conclusion

The nanoseconds property extracts only the nanosecond component (0-999) from a Pandas Timedelta object. Use value property to get the total time duration in nanoseconds.