Diferencia entre revisiones de «Usuario:ManuelRomero/CertificadoWeb2021/IntroduccionPHP/funciones»

Funciones de fechas

• En php hay muchas fucniones para gestionar fechas, siendo esta una tarea frecuente el las aplicaciones web.

Referencias de funciones de fechas en php

https://www.php.net/manual/es/ref.datetime.php

• Vamos a estudiar 5 funciones siendo dos de ellas muy utilizadas

Funciones de fechas

time() https://www.php.net/manual/es/function.time.php date(formato, [timestamp]) https://www.php.net/manual/es/function.date.php strtotime("fecha_string"[timestamp]) https://www.php.net/manual/es/function.strtotime.php strftime(formato, [timestamp]) https://www.php.net/manual/es/function.strftime.php checkdate(mes, dia, año) https://www.php.net/manual/es/function.checkdate.php

• En php se trabaja mucho con las fechas. Para tal cometido existe una clase llamada DateTime y DateTimeInterface (https://www.php.net/manual/es/class.datetime.php), pero muchas de sus acciones se pueden hacer de forma imperativa con funciones que vamos a ver.

time()

Obtiene una marca de tiempo 
https://www.php.net/manual/es/function.time.php

• Esta es una función muy importante en php que conviene entender bien.
• Me retorna el número de segundos transcurridos desde el 1 de Enero de 1970 00:00:00 GMT.

Esta fecha está relacionada con el sistema operativo UNIX que empezó a hacerse visible a partir del año 1970

Un podo de historia desde wikipedia

https://es.wikipedia.org/wiki/Berkeley_Software_Distribution https://es.wikipedia.org/wiki/Unix

• La función time retorna un entero largo numérico

usar time()

Prueba a visualizar el retorno de la función time() Mira lo que ocurre si recargas la página en ejecución, como se van actualizando los segundos Pregunta Entiendes por qué camba el valor Porbando time() Segundos transcurridos desde 1 de enero de 1970 <span style='color:red'>$tiempo </span></h2>"; ?>

date()

• La función convierte un timestamp en una fecha como cadena de caracteres con el formato que le especifiquemos
• Para ver los metaracteres que representan el formato puedes ver la referencia web de la función

Esta función admite dos parámetros, uno de ellos es obligatoria

funcion date()

data("formato_fecha", "timestamp") parámetro 1 formato_fecha Es un string formado por metacaracteres y caracteres literales que establece el formato en el cual queremos ver la fecha (d/m/y H:i:s), por ejemplo, donde d representa el número de día, m del mes ... y los caracteres / y : apareceran literales en la cadena parametro 2 timestamp Es una fecha en formato timestamp o entero largo como segundos desde una fecha Si no se establece, se toma el instante actual, es decir el resultado de la función time()

Ejemplo de uso de date

<?php   $fecha_actual =date("d/m/Y H:i:s"); echo "<h1>La fecha actual es $fecha_actual</h1>";   $fecha_futura =date("d/m/Y H:i:s", time()+24*60*60); echo "<h1>La fecha de mañana será $fecha_futura</h1>";

strtotime()

Convierte un string a fecha. https://www.php.net/manual/es/function.strtotime.php

• Esta función admite dos parámetros, uno de ellos es obligatoria

funcion strtotime

strtotime("fecha_como_string", "timestamp") parámetro 1 fecha_como_string Es una cadena que representa una fecha Debemos facilitarla con el formato que entienda el sistema Por defecto "mes/dia/year" parametro 2 timestamp (opcional, si no se aporta, se toma el valor que retorno time() Es una fecha en formato timestamp o entero largo como segundos desde una fecha Tip: Recuerda que stamptime es un entero largo que respresenta un número de segundos desde el 1 de enero de 1970

Si quisiéramos cambiar el formato, podemos usar la función data_default_timezone_set("Zona_horaria")

Descripción de la función https://www.php.net/manual/es/function.date-default-timezone-set.php
Listado agrupado de diferentes zonas horarias https://www.php.net/manual/es/timezones.php 

• Por ejemplo

<?php
$dia= 27;
$mes = 12;
$year = 2001;
 
$fecha_string="$dia-$mes-$year";
date_default_timezone_set('Europe/Madrid');
$tiempo = strtotime($fecha_string);
echo "<h1>Marca de tiempo de $fecha_string <span style='color:red'>$tiempo</h1>";

El código anterior imprimirá

Ejemplo de uso de strtotime

<?php $dia =27; $mes=11; $year=2001;   $fecha ="$mes/$dia/$year"; $time = strtotime($fecha); echo "<h2>Valor de $fecha es $time</h2>h2>"; <br/>

strftime()

https://www.php.net/manual/es/function.strftime.php

• Da formato a una fecha según el idioma establecido
• Para poder ver el uso de esta función , debemos establecer uno de los idiomas que tengamos instalados en el sistema.
• Para realizar esta acción debemos usar la función setlocale

setlocale()

https://www.php.net/manual/es/function.setlocale.php

Esta función establece un idioma para la fecha, monedas,... Para poder usar esta función debemos tener instalado en el sistema ese conjunto de caracteres de formato para la localidad deseada

Para ver las localidades instaladas puedes usar el comando locale

• En caso de no tenerlo instalarlo hay que hacerlo previamente

Comando relacionados con instalación-configuración de locales

Para instalarlo sudo apt-get install locales Ver locales actualmente instalados locale -a Para instalar nuevos locales sudo dpkg-reconfigure locales Para instalar una localidad (locale) concreta sudo locale-gen "en_US.utf8"

• Saldrá un menú y seleccionaremos las localidades. Vamos a probar teniendo instalados 3 locales

1. es_ES.UTF-8 Español
2. fr_FR.UTF-8 Francés
3. en_US.UTF-8 Inglés

Esta función retorna false o bien la localidad esablecida, si todo ha ido bien

Probando strftime

Mostrar el día de la semana actual en 3 idiomas: inglés, francés y castellano código setlocale(LC_ALL,"fr_FR.utf8"); $dia = strftime("%A"); echo "<h1>FranÇais $dia</h1>"; setlocale(LC_ALL,"es_FR.utf8"); $dia = strftime("%A"); echo "<h1>Castellano $dia</h1>"; setlocale(LC_ALL,"en_US.utf8"); $dia = strftime("%A"); echo "<h1>Inglés $dia</h1>";

checkdate(mes, dia, year)

• Esta función recibe tres enteros que representan una fecha y retorna un booleano que idica si la fecha es o no correcta

Funciones

Objetivo

Las funciones es un elemento fundamental Permite crear código modular Una forma de estructurar nuestro programa

Qué son las funciones

Definición

Una función es una declaración de un conjunto de instrucciones que indentificamos con un nombre, al que le vamos a asignar una serie de acciones o instrucciones y de su ejecución podemos o no obtener un valor como resultado de su ejecución

Son muy importantes

Las funciones son la base de la programación modular Creamos nuestro programa como módulos que van haciendo acciones Una función agrupa una serie de instrucciones relacionadas semáticamente Por ejemplo mostrar_menu(), validar_usuario($usuario), dame_numero_par() El identificador a de ser significativo semánticamente Solo con leer el identificado debemos intuir qué hace esa función Va a evitar duplicar código Si vemos un conjunto de accinoes que repetimos muchas veces, va a ser un claro indicador de que debemos de crear una función Va a permitir hacer código más legible Un código mucho más fácil de leer Es una decisión del programador No debemos obsesionarnos con crear funciones. Surgirán según las veamos y concivamos, Son una herramienta para facilitarnos crear el código, no para complicarnos buscando dónde poder poner una función

function nombreFuncion ($paramFormal1, $paramFormal2 ,...){
  //Instrucciones de la función
  return $valorRetorno //Opcionalmente en caso de que devuelva algún valor la función
}

Identificador de función

• El nombre de función es un identificador que empieza por una letra o guión bajo, seguido 0 o muchas letras, números o guiones bajos

Tip: Expresión regular para el identificador de funciones

[a-zA-Z_f_][a-zA-Z0-9_]*

Parámetros formales

• Son nombres de variables que usaré al escribir el código o cuerpo de la función
• El nombre ha de ser significativo y se convertirán en variables locales a la función
• Una vez que se termina la función estas variables desaparecerán de memoria

parámetros formales

Los parámetros formales son variables locales a la función

Proceso de creación / invocación de una función

Lo primero es declarar una función

• Esto implica dejar una zona de memoria identificada con el nombre de la función
• En contenido de esas posiciones de memoria serán las acciones de la función
• Estas acciones estarán establecidas no con valores reales, sino con los parámetros de la declaración
• Estos parámetros se conocen como parámetros formales

Invocación de función

• Es un tipo de instrucción, invocar a una acción o función.

• lo primero que ocurrirá es que voy a esa zona de memoria

• Lo siguiente es dar los valores reales (de la invocación) a los parámetros de la función (de la declaracion.

• Una vez que la función termina de ejecutarse, se retornará a la instrucción siguiente de la invocación
• Si la función devuelve algún valor, se recogerá y asignará a la variable de la instrucción de asignación desde la cual se invocó

Ejercicio usando funciones

Haz un programa donde en el programa principal se creen dos variables $a y $b Crea una función que reciba como parámetros locales $a y $b La función visualizará el valor de las variables, las modificará y las volverá a visualizar El programa principal asignará valor a las variables las visualizará invocará a la función volverá a visualizar las variables

    <?php
       function a($a, $b){
           echo "Dentro de la función visualizando valores <hr />";
           echo "Valor de los parámetros \$a = $a \$b = $b <br />";
           $a+=5;
           $b+=5;
           echo "Valor de los parámetros \$a = $a \$b = $b <br />";
           echo "Salgo de la función";
       }
       //Ahora considero programa principal
       $a=100;
       $b=200;
       echo "En el main antes de invocar a la función visualizando variables<hr />";
       echo "Valor de variables \$a = $a \$b = $b <br />";
       a($a,$b);
       echo "En el mail  después de invocar a la función visualizando variables<hr />";
       echo "Valor de variables \$a = $a \$b = $b <br />";
?>

function nombre_funcion(&$paramRef1, &$paramRef2, $paramVal1){
   ...
}

Ejercicio usando funciones parámetros

Haz un programa donde en el programa principal se creen dos variables $a y $b y $c Crea una función que reciba como parámetros locales &$num1,&$num2 y $num3 La función visualizará el valor de las variables, las modificará y las volverá a visualizar El programa principal asignará valor a las variables las visualizará invocará a la función volverá a visualizar las variables

  <?php
       function a(&$num1, &$num2, $num3){
           echo "Dentro de la función visibilizando valores <hr />";
           echo "Valor de los parámetros \$num1 = $num1 \$num2 = $num2 \$num3 = $num3<br />";
           $num1+=5;
           $num2+=5;
           $num3+=5;
 
           echo "Valor de los parámetros \$num1 = $num1 \$num2 = $num2 \$num3 = $num3<br />";
           echo "Salgo de la función";
       }
       //Ahora considero programa principal
       $a=100;
       $b=200;
       $c=300;
       echo "En el main antes de invocar a la función visualizando variables<hr />";
       echo "Valor de variables \$a = $a \$b = $b \$c = $c <br />";
       a($a,$b,$c);
       echo "En el mail  después de invocar a la función visualizando variables<hr />";
       echo "Valor de variables \$a = $a \$b = $b \$c = $c <br />";
?>

	ejemplo invocación a funciones
	Tip: Este código funcionará correctamente <?php a(5,6); /*Mas instrucciones*/ function a ($a, $b){ echo "valor de $a"; echo "valor de $b"; }

	ejemplo invocación a funciones
	Tip: Este código no funcionará <?php a(5,6); /*Mas instrucciones*/ include ("funciones.php"); ?> Contenido del ficheor funciones.php <?php function a ($a, $b){ echo "valor de $a"; echo "valor de $b"; } ?>

<?php
 
 
function modifica_valor(){
    echo "Valor de <b>var1</b> dentro de función -$var1- <br /> ";
    $var1++;
    echo "Valor de <b>var1</b> dentro de función moficada -$var1- <br /> ";
}
 
$var1 = 20;
 
echo "Valor de <b>var1</b> en programa principal antes de invocar función: -$var1- <br />";
modifica_valor();
echo "Valor de <b>var1</b> en progrma principal después de invocar la función: -$var1- <br />";
?>

 Valor de var1 en programa principal antes de invocar función: -20- 
Valor de var1 dentro de función -- 
Valor de var1 dentro de función moficada -1- 
Valor de var1 en progrma principal después de invocar la función: -20-

<?php
 
function modifica_valor(){
    global $var1; //Indicamos que esta variables se puede globalizar
    echo "Valor de <b>var1</b> dentro de función -$var1- <br /> ";
    $var1++;
    echo "Valor de <b>var1</b> dentro de función moficada -$var1- <br /> ";
}
 
$var1 = 20;
 
echo "Valor de <b>var1</b> en programa principal antes de invocar función: -$var1- <br />";
modifica_valor();
echo "Valor de <b>var1</b> en progrma principal después de invocar la función: -$var1- <br />";
?>

Valor de var1 en programa principal antes de invocar función: -20- 
Valor de var1 dentro de función -20- 
Valor de var1 dentro de función moficada -21- 
Valor de var1 en progrma principal después de invocar la función: -21-