Office Scripts: Tipos de datos

Un aspecto básico al programar en cualquier lenguaje es aplicar correctamente a constantes y/o variables el tipo de dato asociado a ésta... y por supuesto, Office Scripts no es la excepción.
Hoy repasaremos los distintos tipos de datos que nos podemos encontrar al programar con Office Script.

En la distinta documentación existente al respecto dividen los tipos de datos en dos grandes categorías:
i) primitivos,
ii) objetos.

Si bien nos centraremos en los tipos de datos primitivos, esto es, lo más esenciales que serían: Number, Boolean, String, Symbol, Void, Null y Undefined... además de los definidos por el usuario: enum.
Finalmente, para emplear en nuestra programación alguna de estas categorías deberemos emplear una clave de tipo de datos concreta: number, boolean, string, symbol, void, null y undefined respectivamente...

Por comentar los más frecuentes:
Tipo de datos boolean: el más simple... permite valores true y false.
Tipo de datos number: un número entero o un número con coma flotante.
Tipo de datos string: secuencia de caracteres que representan un valor de texto. NOTA. Se asigna valor entre comillas simples o dobles !!!.
Tipo de datos null: en minúscula... representa el valor vacío, sin dato.
Tipo de datos undefined: valores sin tipo de datos asignado.
Tipo de datos personalizado enum: empleado para asignar nombres, más sencillos de recordar, a los conjuntos de valores (numéricos o de texto).
Por comentar brevemente los objetos, diré que este tipo de dato se usa habitualmente para guardar una colección de datos definidos o entidades más complejas.

Un comentario general es que en Office Scripts, igual que en otros lenguajes, NO es necesario especificar el tipo de dato de una variable cuando la declaramos!!.
Otra ventaja es que los tipos de datos se convierten automáticamente según sea necesario durante la ejecución de nuestros Scripts, pasando si fuera necesario de un tipo de datos a otro.

Veamos en la práctica cómo definir y asignar tipos de datos a variables o constantes.
Por suerte no hay una sola manera ;-)
Una estructura o sintáxis general es:
let/var/const 'nombre variable': tipo de dato = valor dado a la variable
let/var/const 'nombre variable' = valor dado a la variable

Ejemplos:

function main(workbook: ExcelScript.Workbook)
{
  let texto: string = "Excel";
  let num: number = 1234;
  let t_f: boolean = true;
  let sin_dato: null = null;
  enum apps { Excel, Word, Access, Outlook };
  let w: apps = apps.Word;
///
// otra forma de trabajar, sin asignar tipos de datos
let texto2 = 'Excel';
let num2 = 1234;
let verdadero = true;
/// Conversiones...
  let y = num.toFixed(2);
  let t = texto.charAt(2);
  let p_i=parseInt('123.45',0);
  let p_f = parseFloat('123.45');
  let mas= +'3.14'+ +'3.14';

  console.log(num2 + 2);
  console.log(texto2 + 2);
  console.log(w + 2);
  // conversiones
  console.log(y);
  console.log(t);
  console.log(p_i);
  console.log(p_f);
  // más
  console.log(mas);
}

Mencionar algunas funciones que nos permitirán tratar o pasar de un tipo de datos a otro:
Numero.toFixed(num_decimales): devuelve el valor numérico como un TEXTO, con las posiciones decimales indicadas.
Texto.CharAt(posción-en base cero): devuelve la posición indicada (en base cero), obviamente como un TEXTO
.parseInt: convierte un número almacenado como texto a número ENTERO!!.
.parseFloat: convierte un número almacenado como texto a número DECIMAL!!.
Uso del operador +: convierte un número almacenado como texto a número!!. (let mas= +'3.14'+ +'3.14';)