Convertidor de unidades: documentación técnica

Método

Resultado = Valor × Factor(De) ÷ Factor(A)

Cada unidad tiene un factor: cuántas unidades base vale (metro en longitud, kilogramo en masa). Se multiplica por el factor de origen y se divide entre el de destino, en ese orden y sin atajos. Ejemplo, 1/4 in a mm: 0.25 × 0.0254 ÷ 0.001 = 6.35 mm.

Todo se redondea sólo al mostrar. El cálculo del servidor es el de referencia; el navegador repite los mismos pasos y la sección Verificación comprueba que coincidan.

Unidades y factores

Todos los factores son exactos por definición. Cada uno cita al menos dos fuentes oficiales de organismos distintos.

Fuentes oficiales

Cada dato se leyó en el documento publicado, en la página o sección indicada. Un resultado de búsqueda no cuenta como verificación.

Reglas de entrada

El valor se lee con estas comprobaciones, en este orden; el orden decide qué mensaje recibe una entrada con varios problemas.

1. Un carácter fuera del alfabeto ASCII (acentos, símbolos o espacios especiales): «Escribe un número o una fracción (ej. 25.4 o 3/8).»
2. Más de 32 caracteres, contados antes de quitar espacios: «Escribe como máximo 32 caracteres.»
3. Se quitan los espacios de los extremos. Si no queda nada, no hay resultado ni error.
4. Un carácter que no puede formar un número: sólo se admiten dígitos, punto, coma, barra, guion y espacio. Cualquier otro da mensaje de formato.
5. Decimal: entero, decimal con punto o con una coma, o decimal sin parte entera (.5). La coma es decimal.
6. Fracción simple o mixta (3/8, 1 9/16): valor = entero + numerador ÷ denominador. Denominador 0: «El denominador no puede ser 0.»
7. Cualquier otra cosa: mensaje de formato. En 5 y 6, un número con más de 15 dígitos: «Usa como máximo 15 dígitos por número.»

Todas las entradas de ejemplo dan lo esperado.

Reglas de formato

1. En pulgadas, por debajo de 100000000000, si el resultado es múltiplo exacto de 1/64 (tolerancia 1.0e-9), se muestra como fracción reducida: 1/4, 1 9/16, 2. Sólo en el resultado principal; las equivalencias no usan fracción.
2. Cero se muestra como 0.
3. Se muestran 10 cifras significativas, sin ceros de relleno. Las cifras y el exponente se cuentan comparando con potencias de diez exactas (de 10^0 a 10^22), no con un logaritmo, y el redondeo se hace sobre un entero: así el resultado no depende de la biblioteca matemática de cada equipo.
4. Notación científica, con mantisa de hasta 5 decimales, si el valor es ≥ 100000000000, o si es < 1.0e-5 y redondearlo lo cambiaría en más de v × 1.0e-12. Si la mantisa redondeada llega a 10, vuelve a 1 y el exponente sube en 1.
5. La salida siempre usa punto decimal.

Mensaje «multiplica por / divide entre»

Se escriben los dos factores, Factor(De) ÷ Factor(A) para «multiplica por» y Factor(A) ÷ Factor(De) para «divide entre», con 15 cifras significativas. Gana el texto más corto; si empatan, gana «multiplica». Si De y A son la misma unidad, no hay mensaje. Por eso de milímetros a pulgadas se lee «divide entre 25.4» en lugar de «multiplica por 0.0393700787401575».

Prueba

Elige la magnitud, las unidades y el valor. El servidor repite el cálculo y lo explica completo; la URL guarda la prueba para compartirla.

Verificación con el navegador: —

Enlace permanente: /convertidor-de-unidades/docs?cat=longitud&de=in&a=mm&v=#prueba

Verificación servidor ↔ navegador

El navegador recalcula por su cuenta cada caso que calculó el servidor (la prueba, los casos de referencia y cada pareja De → A con la entrada 1) y compara campo por campo: estado, valor leído, resultado sin redondear, resultado mostrado, eco, mensaje, factor y cada equivalencia. Los números se comparan como números, no como texto.

Matrices de factores

El factor Factor(De) ÷ Factor(A) de cada pareja, calculado en esta petición: la fila es De y la columna es A. Todas las celdas coinciden con la matriz de referencia.

Casos de referencia

Los casos de la hoja de cálculo de referencia y los propios del convertidor. El servidor da el resultado y el mensaje esperados en todos. Si un caso deja de coincidir, no se ajusta el caso: se revisa el cálculo.

Diferencias con la hoja de referencia

Deliberadas; ninguna altera los casos de referencia.

Limitaciones

• Se opera en punto flotante de doble precisión (64 bits); los factores son exactos, pero su representación binaria no siempre lo es.
• Se muestran 10 cifras significativas.
• La entrada no admite negativos ni notación científica.
• Cada número admite hasta 15 dígitos y la entrada, hasta 32 caracteres.
• La coma es decimal: «1,000» se lee como 1.
• Sólo longitud y masa.

Agregar una unidad o una magnitud

1. Localizar dos fuentes oficiales de organismos distintos y leer el valor en la página citada. Sin eso, la unidad no entra.
2. Registrar la unidad con su clave estable, su etiqueta, su nombre y su factor exacto respecto de la unidad base de su magnitud, junto con sus dos fuentes.
3. Agregar sus casos de referencia, calculados a mano o tomados de una tabla oficial.
4. Comprobar que esta página la muestra sola y que la verificación dice «Coinciden todos».
5. Una magnitud nueva necesita su propia decisión; si no es proporcional (temperatura) o admite negativos, también reglas nuevas en los dos cálculos, el del servidor y el del navegador.
6. Nunca cambiar el factor ni la clave de una unidad publicada sin una decisión registrada.