Asistentes

Los asistentes son clases con funciones que nos ayudan a crear nuestro programa. Tenemos asistentes para fechas, cadenas y url's.

Fechas

La clase Date contiene las funciones para asistirnos con las fechas.

• now()

  Devuelve una cadena con la fecha actual en formato yyyy-MM-dd HH:mm:ss. No tiene parámetros.

  Ejemplo de uso:

          
            echo Date::now();
            // Imprime:
            $dateTime
          
        

• diff( $interval, $date1, $date2 )

  Calcula la diferencia entre dos fechas. Tiene los siguientes parámetros.

  • $interval( String ).- Es un caracter, que puede ser:
    • y Para año
    • m Para mes
    • d Para dia
    • h Para hora
    • i Para minuto
    • s Para segundo
  • $date1( String / Datetime ).- Es la primera fecha a considerar para la diferencia. Puede ser un objeto Datetime o una cadena en formato fecha.
  • $date2( String / Datetime ).- Es la segunda fecha a considerar para la diferencia. Puede ser un objeto Datetime o una cadena en formato fecha.

  Regresa un valor flotante, la diferencia entre ambas fechas.

  Ejemplo de uso:

          
            $date1 = '2013-11-23 08:34:12';
            $date2 = '2016-10-23 22:23:54';
            echo "Diferencia en: \n";
            echo "Años: "     . Date::diff( 'y', $date1, $date2 ) . "\n";
            echo "Meses: "    . Date::diff( 'm', $date1, $date2 ) . "\n";
            echo "Dias: "     . Date::diff( 'd', $date1, $date2 ) . "\n";
            echo "Horas: "    . Date::diff( 'h', $date1, $date2 ) . "\n";
            echo "Minutos: "  . Date::diff( 'i', $date1, $date2 ) . "\n";
            echo "Segundos: " . Date::diff( 's', $date1, $date2 ) . "\n";
  
            //  Imprime:
            //  Diferencia en:
            //  Años:     2.9172745075671
            //  Meses:    35.007294090805
            //  Dias:     1065.5345138889
            //  Horas:    25572.828333333
            //  Minutos:  1534369.7
            //  Segundos: 92062182
          
        

Cadenas

La clase String es la encargada de asistirnos con las cadenas. Tiene la siguientes funciones:

• isUppercase( $string )

  Determina si $string está en mayúsculas. Su único parámetro es:

  • $string( String ).- Es la cadena que deseamos verificar si es mayúsculas.

  Ejemplo de uso:

          
            $isUpper = String::isUppercase( 'HELLO MY NAME IS' );
            //  Imprime true
            echo $isUpper;
  
            $isUpper = String::isUppercase( 'hello my name is' );
            //  Imprime false
            echo $isUpper;
          
        

• contains( $str, $val )

  Regresa true si la cadena $val se encuentra en la cadena $str. Sus parámetros son:

  • $str(String).- Cadena en la cual se buscará un contenido.
  • $val(String).- Cadena de texto que se buscará dentro de otra.

  Ejemplo de uso:

          
            if ( String::contains( 'Hola me llamo Luis', 'llamo' ) ) {
              //  Do something if contains
              echo "Esta contenida!";
            } else {
              //  Do something id not contains
              echo "No está contenida";
            } // end if then else contains
          
        

• startsWith( $str, $value )

  Verifica si una cadena de texto comienza con otra. Sus parámetros son:

  • $str( String ).-
  Es la cadena en la cual buscar.
  • $value( String ).-
  El valor a buscar en el principio de la cadena.

  Ejemplo de uso:

          
            $str = "Hola me llamo Slim Shady!";
            $value = "Hola";
            //  Verifica si $str comienza con $value
            //  Imprime 1
            echo String::startsWith( $str, $val );
  
            //  Cambiamos el valor:
            $value = "me llamo"
            //  Verifica si $str comienza con $value
            //  Imprime 0, es false
            echo String::startsWith( $str, $val );
          
        

• endsWith( $str, $value )

  Verifica si una cadena de texto termina con otra. Sus parámetros son:

  • $str( String ).-
  Es la cadena en la cual buscar.
  • $value( String ).-
  El valor a buscar en la final de la cadena.

  Ejemplo de uso:

          
            $str = "Hola me llamo Slim Shady!";
            $value = "Shady!";
            //  Verifica si $str termina con $value
            //  Imprime 1
            echo String::endsWith( $str, $val );
  
            //  Cambiamos el valor:
            $value = "Slim"
            //  Verifica si $str termina con $value
            //  Imprime 0, es false
            echo String::endsWith( $str, $val );
          
        

• left( $str, $n )

  Obtiene la parte izquierda de una cadena de texto, "n" numero de caracteres.

  • $str( String ).-
  Es la cadena de la cual se va a obtener la parte izquierda.
  • $n( Integer ).-
  El número de caracteres que deseamos devolver.

  Ejemplo de uso:

          
            $str = "Hola me llamo Slim Shady!";
            $n = 7;
            // Imprime Hola me
            echo String::left( $str, 7 );
          
        

• right( $str, $n )

  Obtiene la parte derecha de una cadena de texto, "n" numero de caracteres.

  • $str( String ).-
  Es la cadena de la cual se va a obtener la parte derecha.
  • $n( Integer ).-
  El número de caracteres que deseamos devolver.

  Ejemplo de uso:

          
            $str = "Hola me llamo Slim Shady!";
            $n = 6;
            // Imprime Shady!
            echo String::right( $str, 6 );
          
        

• stripAccents( $str )

  Elimina los acentos en una cadena.

  • $str( String ).-
  Es la cadena de la cual se van a eliminar los acentos.

  Ejemplo de uso:

          
            $str = "¿Cuál es el avión de él?";
            // ¿Cual es el avion de el?
            echo String::stripAccentes( $str );
          
        

• replace

  Reemplaza una cadena por otra, dentro de una tercera cadena de texto. Puedes llamar a esta función dedos maneras, la primera es la clásica forma de Php ( busqueda, reemplazo, cadena original ) y la segunda es utilizando un diccionario de datos mediante un arreglo asociativo.

  stringReplace( $search, $replace, $string )
  • $search( String / Assoc Array ).- Es la cadena o arreglo de cadenas a buscar.
  • $replace( String / Assoc Array ).- Es la cadena o arreglo de cadenas a reemplazar.
  • $str( String ).- Es la cadena de texto sobre la cual se van a efectuar los reemplazos.

          
            $str = "¡Hola mundo!";
            $search = "mundo";
            $replace = "Luis";
            echo String::replace( $search, $replace, $str );
            //  Imprime:
            //  ¡Hola Luis!
          
        

  replace( $dictionary, $str )
  • $dictionary( Assoc Array ).- Es un arreglo asociativo en el cual la llave es la cadena a buscar y el valor es la cadena para reemplazar.
  • $str( String ).- Es la cadena de texto sobre la cual se van a efectuar los reemplazos.

          
            $str = "Luke y Han son rebeldes.";
            $dictionary = array(
              "Luke" => "R2D2",
              "Han" => "C3PO",
              "rebeldes" => "androides"
            );
            echo String::replace( $dictionary, $str );
            //  Imprime:
            //  R2D2 y C3PO son androides
          
        

• specialCharsToHTML( $str )

  Convierte los caracteres especiales en una cadena a html válido.

  • $str( String ).-
  Es la cadena a modificar.

  Ejemplo de uso:

          
            $str = "¿Eres tú? ¿No perdiste el avión?";
            echo String::specialCharsToHTML( $str );
            //  Imprime:
            //  ¿Eres tú? ¿No perdiste el avión?
          
        

• toUpper( $str )

  Convierte la cadena a solo mayúsculas, incluyendo los acentos.

  • $str( String ).-
  Es la cadena a convertir en mayúsculas

  Ejemplo de uso:

          
            $str = "El invierno está cerca.";
            echo String::toUpper( $str );
            //  Imprime:
            //  EL INVIERNO ESTÁ ACERCA
          
        

• toLower( $string )

  Convierte la cadena a solo minúsculas, incluyendo los acentos.

  • $str( String ).-
  Es la cadena a convertir en minúsculas

  Ejemplo de uso:

          
            $str = "LO SIENTO DAVE. NO PUEDO HACER ESO.";
            echo String::toLower( $str );
            //  Imprime:
            //  lo siento dave. no puedo hacer eso.
          
        

• UUID()

  Regresa un identificador universal único. No tiene parámetros.

  Ejemplo de uso:

          
            echo String::UUID();
            //  Imprime:
            //  4c15901f-e57d-4f8c-9327-016b1c368f22
          
        

• random( $len, $useSymbols )

  Regresa una cadena aleatoria de "n" caracteres.

  • $len( Integer ).-
  La longitud que tendrá la cadena.
  • $useSymbols( Boolean, default = false ).-
  Indica si deberán utilizarse caracteres especiales. Por defecto esfalse.

  Ejemplo de uso:

          
            echo String::random( 20 );
            //  Imprime:
            //  XystBZ2Zk9AhEyPjj8TG
  
            echo String::random( 15, true );
            //  Imprime:
            //  -}mySMKjx%lX):k
          
        

• isBase64( $str )

  Devuelve true si la cadena es base 64

  • $str( String ).-
  La cadena de texto a verificar si es base 64.

  Ejemplo de uso:

          
            if ( String::isBase64( 'TmV2ZXIgYXJndWUgd2l0aCB0aGUgZGF0YS4=' ) ) {
              //  Hacer algo si es base 64
              echo "Exito! Es base 64";
            } else {
              //  Hacer algo si no
              echo "Lo siento, no es base 64";
            }  // end if then else is base64