Duration Object Members in SuiteScript Reference Guide

The Duration object in SuiteScript enables developers to define and manage duration periods effectively. It consists of specific members that facilitate handling time-related data within server-side scripts, thereby enhancing the scripting capabilities in NetSuite.

What Are the Duration Object Members?

The Duration object comprises two significant members:

Property: Duration.amount

• Type: number
• Description: This property captures the numeric value representing the duration amount, such as days, hours, or minutes.
• Supported Script Types: This property can be utilized in server scripts.
• Error Handling: If there is an attempt to set the value of this property after the Duration object has been instantiated, the error code READ_ONLY_PROPERTY will be thrown.

Property: Duration.units

• Type: Object
• Description: This property contains the specific units that are applied to the duration amount, allowing flexibility in working with various time measurements such as seconds, minutes, hours, etc.
• Supported Script Types: Like the amount property, this can also be used within server scripts.

Contextual Use

The Duration object members are primarily utilized within scripts that need to perform time calculations or when logging durations in user interfaces, workflows, or automated processes in NetSuite. For instance, if you are developing a scenario where task completion time is logged, using the Duration object supports precise tracking.

For more extensive practices and structural integration, refer to the N/workbook Module documentation. Utilizing these properties allows developers to build more robust and flexible scripts tailored to their business requirements.