Funciones de Conversion

Las funciones de conversion permiten convertir valores entre tipos FHIRPath (Boolean, Integer, Decimal, String, Date, DateTime, Time, Quantity) y verificar si dichas conversiones son posibles. La funcion iif proporciona evaluacion condicional.

Cada funcion to* realiza la conversion real (devolviendo vacio si la conversion falla), mientras que su correspondiente funcion convertsTo* devuelve un booleano indicando si la conversion tendria exito.

iif

Funcion condicional que devuelve uno de dos valores dependiendo de una condicion booleana. Este es el equivalente en FHIRPath de un operador ternario.

Firma:

iif(condition : Boolean, trueResult : Expression [, falseResult : Expression]) : Collection

Parametros:

Tipo de Retorno: Collection

Ejemplos:

result, _ := fhirpath.Evaluate(patient, "iif(Patient.active, 'Active', 'Inactive')")
// Returns 'Active' if patient is active, 'Inactive' otherwise

result, _ := fhirpath.Evaluate(patient, "iif(Patient.birthDate.exists(), Patient.birthDate, 'Unknown')")
// Returns birth date if it exists, otherwise 'Unknown'

result, _ := fhirpath.Evaluate(patient, "iif(Patient.gender = 'male', 'M', 'F')")
// Returns 'M' or 'F' based on gender

Casos Limite / Notas:

• Si la condicion esta vacia o no es booleana, se trata como false.
• Si el falseResult no se proporciona y la condicion es false, devuelve una coleccion vacia.
• Ambas ramas se evaluan como expresiones y se pasan como colecciones.

toBoolean

Convierte la entrada a un valor Boolean.

Firma:

toBoolean() : Boolean

Tipo de Retorno: Boolean

Reglas de Conversion:

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'true'.toBoolean()")
// true

result, _ := fhirpath.Evaluate(resource, "(1).toBoolean()")
// true

result, _ := fhirpath.Evaluate(resource, "'yes'.toBoolean()")
// true

Casos Limite / Notas:

• Devuelve una coleccion vacia si la entrada no puede convertirse (por ejemplo, 'maybe'.toBoolean()).
• Devuelve una coleccion vacia si la entrada esta vacia.
• La comparacion de cadenas no distingue entre mayusculas y minusculas.

convertsToBoolean

Devuelve true si la entrada puede convertirse a Boolean usando toBoolean().

Firma:

convertsToBoolean() : Boolean

Tipo de Retorno: Boolean

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'true'.convertsToBoolean()")
// true

result, _ := fhirpath.Evaluate(resource, "'maybe'.convertsToBoolean()")
// false

result, _ := fhirpath.Evaluate(resource, "(1).convertsToBoolean()")
// true

Casos Limite / Notas:

• Devuelve false para entrada vacia.
• Devuelve false para valores Integer distintos de 0 y 1.

toInteger

Convierte la entrada a un valor Integer.

Firma:

toInteger() : Integer

Tipo de Retorno: Integer

Reglas de Conversion:

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'42'.toInteger()")
// 42

result, _ := fhirpath.Evaluate(resource, "true.toInteger()")
// 1

result, _ := fhirpath.Evaluate(resource, "(3.7).toInteger()")
// 3

Casos Limite / Notas:

• Devuelve una coleccion vacia si la entrada no puede convertirse (por ejemplo, 'abc'.toInteger()).
• Devuelve una coleccion vacia si la entrada esta vacia.
• Para entrada Decimal, la parte fraccionaria se descarta (truncamiento hacia cero).

convertsToInteger

Devuelve true si la entrada puede convertirse a Integer usando toInteger().

Firma:

convertsToInteger() : Boolean

Tipo de Retorno: Boolean

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'42'.convertsToInteger()")
// true

result, _ := fhirpath.Evaluate(resource, "'3.14'.convertsToInteger()")
// false

result, _ := fhirpath.Evaluate(resource, "true.convertsToInteger()")
// true

Casos Limite / Notas:

• Devuelve false para entrada vacia.
• Devuelve true para valores Decimal (siempre pueden truncarse).
• Devuelve false para cadenas que no son enteros validos.

toDecimal

Convierte la entrada a un valor Decimal.

Firma:

toDecimal() : Decimal

Tipo de Retorno: Decimal

Reglas de Conversion:

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'3.14'.toDecimal()")
// 3.14

result, _ := fhirpath.Evaluate(resource, "(42).toDecimal()")
// 42.0

result, _ := fhirpath.Evaluate(resource, "true.toDecimal()")
// 1.0

Casos Limite / Notas:

• Devuelve una coleccion vacia si la entrada no puede convertirse.
• Devuelve una coleccion vacia si la entrada esta vacia.
• Utiliza la biblioteca shopspring/decimal para aritmetica decimal precisa.

convertsToDecimal

Devuelve true si la entrada puede convertirse a Decimal usando toDecimal().

Firma:

convertsToDecimal() : Boolean

Tipo de Retorno: Boolean

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'3.14'.convertsToDecimal()")
// true

result, _ := fhirpath.Evaluate(resource, "'not-a-number'.convertsToDecimal()")
// false

result, _ := fhirpath.Evaluate(resource, "(42).convertsToDecimal()")
// true

Casos Limite / Notas:

• Devuelve false para entrada vacia.
• Integer, Decimal y Boolean siempre se convierten a Decimal.

toString

Convierte la entrada a una representacion String.

Firma:

toString() : String

Tipo de Retorno: String

Reglas de Conversion:

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "(42).toString()")
// '42'

result, _ := fhirpath.Evaluate(resource, "true.toString()")
// 'true'

result, _ := fhirpath.Evaluate(resource, "(3.14).toString()")
// '3.14'

Casos Limite / Notas:

• Devuelve una coleccion vacia si la entrada esta vacia.
• Todos los tipos primitivos pueden convertirse a cadena usando su representacion .String().

convertsToString

Devuelve true si la entrada puede convertirse a String usando toString().

Firma:

convertsToString() : Boolean

Tipo de Retorno: Boolean

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "(42).convertsToString()")
// true

result, _ := fhirpath.Evaluate(resource, "true.convertsToString()")
// true

result, _ := fhirpath.Evaluate(resource, "'hello'.convertsToString()")
// true

Casos Limite / Notas:

• Devuelve false para entrada vacia.
• Devuelve true para todos los tipos primitivos (String, Boolean, Integer, Decimal).
• Devuelve false para tipos complejos (objetos).

toDate

Convierte la entrada a un valor Date.

Firma:

toDate() : Date

Tipo de Retorno: Date

Reglas de Conversion:

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'2024-01-15'.toDate()")
// @2024-01-15

result, _ := fhirpath.Evaluate(patient, "Patient.birthDate.toDate()")
// Returns the birth date as a Date type

result, _ := fhirpath.Evaluate(resource, "'not-a-date'.toDate()")
// { } (empty - invalid date string)

Casos Limite / Notas:

• Devuelve una coleccion vacia si la entrada no puede analizarse como fecha.
• Devuelve una coleccion vacia si la entrada esta vacia.
• Para entrada DateTime, extrae los primeros 10 caracteres (la porcion de fecha).

convertsToDate

Devuelve true si la entrada puede convertirse a Date usando toDate().

Firma:

convertsToDate() : Boolean

Tipo de Retorno: Boolean

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'2024-01-15'.convertsToDate()")
// true

result, _ := fhirpath.Evaluate(resource, "'not-a-date'.convertsToDate()")
// true (basic check -- returns true for any string)

result, _ := fhirpath.Evaluate(resource, "(42).convertsToDate()")
// false

Casos Limite / Notas:

• Devuelve false para entrada vacia.
• La implementacion actual realiza una verificacion basica de tipo (devuelve true para cualquier cadena). Esto puede mejorarse en versiones futuras con una validacion mas estricta del formato de fecha.

toDateTime

Convierte la entrada a un valor DateTime.

Firma:

toDateTime() : DateTime

Tipo de Retorno: DateTime

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'2024-01-15T10:30:00Z'.toDateTime()")
// @2024-01-15T10:30:00Z

result, _ := fhirpath.Evaluate(resource, "'2024-01-15'.toDateTime()")
// Converts date string to DateTime

result, _ := fhirpath.Evaluate(resource, "(42).toDateTime()")
// { } (empty - integer cannot convert to DateTime)

Casos Limite / Notas:

• Devuelve una coleccion vacia si la entrada no puede convertirse.
• Devuelve una coleccion vacia si la entrada esta vacia.
• Actualmente acepta entrada String para la conversion.

convertsToDateTime

Devuelve true si la entrada puede convertirse a DateTime usando toDateTime().

Firma:

convertsToDateTime() : Boolean

Tipo de Retorno: Boolean

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'2024-01-15T10:30:00Z'.convertsToDateTime()")
// true

result, _ := fhirpath.Evaluate(resource, "(42).convertsToDateTime()")
// false

Casos Limite / Notas:

• Devuelve false para entrada vacia.
• Devuelve true para entrada String (verificacion basica de tipo).

toTime

Convierte la entrada a un valor Time.

Firma:

toTime() : Time

Tipo de Retorno: Time

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'14:30:00'.toTime()")
// @T14:30:00

result, _ := fhirpath.Evaluate(resource, "'10:00:00.000'.toTime()")
// @T10:00:00.000

result, _ := fhirpath.Evaluate(resource, "(42).toTime()")
// { } (empty - integer cannot convert to Time)

Casos Limite / Notas:

• Devuelve una coleccion vacia si la entrada no puede convertirse.
• Devuelve una coleccion vacia si la entrada esta vacia.
• Actualmente acepta entrada String para la conversion.

convertsToTime

Devuelve true si la entrada puede convertirse a Time usando toTime().

Firma:

convertsToTime() : Boolean

Tipo de Retorno: Boolean

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'14:30:00'.convertsToTime()")
// true

result, _ := fhirpath.Evaluate(resource, "(42).convertsToTime()")
// false

Casos Limite / Notas:

• Devuelve false para entrada vacia.
• Devuelve true para entrada String (verificacion basica de tipo).

toQuantity

Convierte la entrada a un valor Quantity, opcionalmente con una unidad especificada.

Firma:

toQuantity([unit : String]) : Quantity

Parametros:

Tipo de Retorno: Quantity

Reglas de Conversion:

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "(42).toQuantity('mg')")
// 42 'mg'

result, _ := fhirpath.Evaluate(resource, "'5.5 mg'.toQuantity()")
// 5.5 'mg' (parsed from string)

result, _ := fhirpath.Evaluate(resource, "(3.14).toQuantity()")
// 3.14 (unitless quantity)

Casos Limite / Notas:

• Devuelve una coleccion vacia si la entrada no puede convertirse.
• Devuelve una coleccion vacia si la entrada esta vacia.
• El analisis de cadenas soporta notacion de unidades UCUM.

convertsToQuantity

Devuelve true si la entrada puede convertirse a Quantity usando toQuantity(). Opcionalmente verifica si la cantidad puede expresarse en la unidad especificada.

Firma:

convertsToQuantity([unit : String]) : Boolean

Parametros:

Tipo de Retorno: Boolean

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "(42).convertsToQuantity()")
// true

result, _ := fhirpath.Evaluate(resource, "'5.5 mg'.convertsToQuantity()")
// true

result, _ := fhirpath.Evaluate(resource, "'not-a-quantity'.convertsToQuantity()")
// false

Casos Limite / Notas:

• Devuelve false para entrada vacia.
• Integer y Decimal siempre se convierten a Quantity.
• Cuando se especifica una unidad objetivo, verifica la compatibilidad de unidades UCUM entre las unidades de origen y destino usando normalizacion.