Rut
in package
Clase para trabajar con identificadores RUT, y RUN, de Chile.
Table of Contents
Constants
- RUT_MAX = 99999999
- Se define que un RUT no puede ser mayor que 99.999.999.
- RUT_MIN = 1000000
- Se define que un RUT no puede ser menos que 1.000.000.
Methods
- addDv() : string
- Agrega el dígito verificador al RUT y lo entrega como un string con el DV concatenado al final (sin formato).
- calculateDv() : string
- Calcula el dígito verificador de un RUT.
- format() : string
- Formatea un RUT al formato: 11222333-4.
- formatFull() : string
- Formatea un RUT al formato: 11.222.333-4.
- removeDv() : int
- Entrega la parte numérica del RUT a partir de un RUT que tiene DV.
- toArray() : array<string|int, mixed>
- Extrae de un RUT las 2 partes: el RUT en si (solo el número) y el dígito verificador.
- validate() : void
- Valida el RUT ingresado.
- addThousandsSeparator() : string
- Agrega el separador de miles al RUT y lo entrega como string.
- formatAsString() : string
- Entrega el RUT formateado como string pero sin puntos.
- formatFromInt() : string
- Da formato al RUT a partir de un RUT que venía como número (sin DV).
- formatFromString() : string
- Da formato al RUT a partir de un RUT que venía como string (con DV).
- removeThousandsSeparatorAndDash() : string
- Limpia el RUT quitando el separador de miles (que pude venir con punto o comas) y el guión.
Constants
RUT_MAX
Se define que un RUT no puede ser mayor que 99.999.999.
private
mixed
RUT_MAX
= 99999999
Si bien legalmente podrían existir RUT o RUN mayores a este. En la práctica (año 2024) no deberían existir RUT o RUN vigentes, en uso, que sean mayores a este máximo definido acá.
RUT_MIN
Se define que un RUT no puede ser menos que 1.000.000.
private
mixed
RUT_MIN
= 1000000
Si bien legalmente podrían existir RUT o RUN menores a este. En la práctica (año 2024) no deberían existir RUT o RUN vigentes, en uso, que sean menores a este mínimo definido acá.
Methods
addDv()
Agrega el dígito verificador al RUT y lo entrega como un string con el DV concatenado al final (sin formato).
public
static addDv(int $rut) : string
Parameters
- $rut : int
-
RUT en formato número y sin dígito verificador.
Return values
string —String con el RUT con dígito verificador, sin formato.
calculateDv()
Calcula el dígito verificador de un RUT.
public
static calculateDv(int $rut) : string
Parameters
- $rut : int
-
RUT al que se calculará el dígito verificador.
Return values
string —Dígito verificador calculado para el RUT indicado.
format()
Formatea un RUT al formato: 11222333-4.
public
static format(string|int $rut) : string
NOTE: Este método no agrega puntos al RUT, si se desea usar el RUT con puntos se debe utilizar formatFull().
Parameters
- $rut : string|int
Return values
stringformatFull()
Formatea un RUT al formato: 11.222.333-4.
public
static formatFull(string|int $rut) : string
Parameters
- $rut : string|int
Return values
stringremoveDv()
Entrega la parte numérica del RUT a partir de un RUT que tiene DV.
public
static removeDv(string $rut) : int
Parameters
- $rut : string
-
RUT completo, con DV (puntos y guión opcionales).
Return values
int —Parte numérica del RUT (no incluye DV).
toArray()
Extrae de un RUT las 2 partes: el RUT en si (solo el número) y el dígito verificador.
public
static toArray(string $rut) : array<string|int, mixed>
Parameters
- $rut : string
-
RUT completo, con DV (puntos y guión opcionales).
Return values
array<string|int, mixed> —Un arreglo con 2 elementos: rut (int) y dv (string).
validate()
Valida el RUT ingresado.
public
static validate(string $rut) : void
Parameters
- $rut : string
-
RUT con dígito verificador (puntos y guión opcionales).
Tags
addThousandsSeparator()
Agrega el separador de miles al RUT y lo entrega como string.
private
static addThousandsSeparator(int $rut) : string
Parameters
- $rut : int
-
Solo el número del RUT, sin DV.
Return values
string —Parte numérica del RUT como string con separador de miles.
formatAsString()
Entrega el RUT formateado como string pero sin puntos.
private
static formatAsString(string $rut) : string
Básicamente, toma el RUT y:
- Le quita los separadores de miles.
- Se asegura de que tenga guión, si no lo tenía.
Parameters
- $rut : string
-
RUT con DV (puntos y guión opcionales).
Return values
string —RUT con DV y guión, sin puntos.
formatFromInt()
Da formato al RUT a partir de un RUT que venía como número (sin DV).
private
static formatFromInt(int $rut) : string
Parameters
- $rut : int
Return values
stringformatFromString()
Da formato al RUT a partir de un RUT que venía como string (con DV).
private
static formatFromString(string $rut) : string
Parameters
- $rut : string
Return values
stringremoveThousandsSeparatorAndDash()
Limpia el RUT quitando el separador de miles (que pude venir con punto o comas) y el guión.
private
static removeThousandsSeparatorAndDash(string $rut) : string
Parameters
- $rut : string
-
RUT completo posiblemente con puntos y guión.
Return values
string —Entrega el RUT en formato 112223334.