Comment formater une date JavaScript pour les champs de date/heure de NetSuite dans SuiteScript ?

Pour formater correctement un objet Date JavaScript destiné à un champ Date/Heure de NetSuite, la méthode à utiliser dépend de la version de SuiteScript employée.

Pour les environnements SuiteScript 1.0 :

Les développeurs doivent utiliser la fonction nlapiDateToString

, en spécifiant le format datetimetz

. Cette fonction convertit l’objet Date JavaScript en une chaîne de caractères que les champs Date/Heure de NetSuite peuvent interpréter correctement, y compris les informations relatives au fuseau horaire.

javascript
nlapiDateToString(dateObject, 'datetimetz')

Pour les environnements SuiteScript 2.x modernes (approche recommandée) :

Le module N/format

offre des fonctionnalités robustes pour le formatage de la date et de l’heure. Il convient d’utiliser la méthode format.format()

en spécifiant format.Type.DATETIMETZ

pour les champs nécessitant une date, une heure et un fuseau horaire.

javascript
require(['N/format'], function(format) {
    var myDate = new Date(); // Your JavaScript Date object
    var formattedDateString = format.format({
        value: myDate,
        type: format.Type.DATETIMETZ
    });
    // Use formattedDateString to set the field value, e.g., record.setValue({fieldId: 'yourfield', value: formattedDateString});
});

Par ailleurs, pour de nombreuses opérations record.setValue()

dans SuiteScript 2.x, un objet Date natif de JavaScript peut souvent être transmis directement au champ. NetSuite se chargera alors de la conversion en fonction du type du champ et des paramètres de fuseau horaire de l’utilisateur.

javascript
record.setValue({
    fieldId: 'custrecord_yourdatetimefield',
    value: new Date() // Pass native JavaScript Date object
});

Cela garantit que la date et l’heure, ainsi que le fuseau horaire associé, sont correctement enregistrés dans les champs Date/Heure de NetSuite, ce qui évite toute divergence dans les données.