posts

Cet article passe très rapidement en revue les petits plus de TypeScript. Il est destiné aux personnes qui ne connaissent pas (encore) TypeScript.

Typage des variables

Contrairement à JavaScript, TypeScript est un langage fortement typé.

Lorsque vous définissez une variable ou une constante, vous pouvez définir son type de façon explicite. Les trois principaux types sont number, string et boolean.

Par exemple :

let nombre: number = 100;

const chaine: string = 'Une chaîne de caractères';

let boo: boolean = true;

Le typage peut également se faire d’une façon implicite, lors de l’affectation :

let nombre = 100;

const chaine = 'Une chaîne de caractères';

let boo = true;

Ici, nombre est clairement de type number, chaine de type string et boo de type boolean.

Chaînes de caractères

Les chaînes de caractères peuvent être définies sur plusieurs lignes en les encadrant par des cotes penchées (`). Ces cotes sont accessibles en appuyant simultanément sur les touches Alt Gr et 7.

let chaine = `Cette chaîne

est définie

sur plusieurs lignes`;

Il est possible d’inclure des variables ou des expressions dans des chaînes en les encapsulant entre ${} :

let a = 10;

let chaine = `La variable a vaut ${a}.`;

Enumérations

Vous pouvez définir des énumérations en TypeScript :

enum taille {

  grand = 10,

  moyen = 5,

  petit = 0;

}

Déstructuration

Il est possible d’affecter simultanément plusieurs données en utilisant des tableaux ou des objets littéraux :

let [a,b,c] = ['a','b','c'];

let t = ['d','e','f'];

[a,b,c] = t; //Déstructuration de tableau

console.log(a,b,c); // d e f

let rect = { x: 1, y: 2, width: 3, height: 4 };

let { width, height, x, y } = rect; //Déstructuration de littéral

console.log(x, y, width, height); // 1,2,3,4

Fonctions fléchées (arrow functions)

Ce code :

let resultat = function(a,b) {

  return a*b;

}

Est équivalent à :

let resultat = (a,b) =>  a*b;

Variables immuables

Les variables définies dans une méthode peuvent être immuables (constantes). Pour les déclarer, vous utiliserez le mot-clé const :

const a = 5;

const taille = {

  largeur: 100,

  hauteur : 30

}

Il existe de nombreux autres concepts très intéressants en TypeScript, mais cette brève introduction devrait suffire pour manipuler Excel à travers l’API. Si vous voulez aller plus loin, je vous suggère de consulter ce site : https://cdiese.fr/syntaxe-typescript-en-10-min/.

La bibliothèque Moment.js est très pratique car elle contient des fonctions pour soustraire et pour ajouter des informations horaires.

Voici quelques exemples.

La date dans 25 jours

Pour connaitre la date dans 25 jours, vous utiliserez la fonction moment().date(25,’days’).calendar() :

async function dans25jours() {

  await Excel.run(async (context) => {

    const feuille = context.workbook.worksheets.getActiveWorksheet();

    let date = moment().add(25,'days').calendar();

    feuille.getRange("A3").numberFormat = [["dddd D/MM/YYYY"]];

    feuille.getRange("A3").values = [[date]];

    await context.sync();

  });

}

Ce code est très semblable aux précédents, si ce n’est l’utilisation de la fonction add() pour obtenir la date dans 25 jours :

let date = moment().add(25,'days').calendar();

Voici un exemple d’exécution :

L’heure il y a 6 heures 30

Il est très simple de connaitre l’heure il y a 6 heures 30. Vous utiliserez pour cela la fonction moment().date(6.5,’hours’).calendar() :

async function ilya6heures30() {

  await Excel.run(async (context) => {

    const feuille = context.workbook.worksheets.getActiveWorksheet();

    let date = moment().subtract(6.5, 'hours').calendar();

    feuille.getRange("B3").numberFormat = [["hh:mm:ss"]];

    feuille.getRange("B3").values = [[date]];

    await context.sync();

  });

}

Voici un exemple d’exécution :