/** * Date Functions * * @package EDD * @subpackage Functions * @copyright Copyright (c) 2018, Easy Digital Downloads, LLC * @license http://opensource.org/licenses/gpl-2.0.php GNU Public License * @since 3.0 */ /** * Retrieves a localized, formatted date based on the WP timezone rather than UTC. * * @since 3.0 * * @param int $timestamp Timestamp. Can either be based on UTC or WP settings. * @param string $format Optional. Accepts shorthand 'date', 'time', or 'datetime' * date formats, as well as any valid date_format() string. * Default 'date' represents the value of the 'date_format' option. * @return string The formatted date, translated if locale specifies it. */ function edd_date_i18n( $timestamp, $format = 'date' ) { $format = edd_get_date_format( $format ); // If timestamp is a string, attempt to turn it into a timestamp. if ( ! is_numeric( $timestamp ) ) { $timestamp = strtotime( $timestamp ); } // We need to get the timezone offset so we can pass that to date_i18n. $date = EDD()->utils->date( 'now', edd_get_timezone_id(), false ); return date_i18n( $format, (int) $timestamp + $date->getOffset() ); } /** * Retrieve timezone ID * * @since 1.6 * @return string $timezone The timezone ID */ function edd_get_timezone_id() { return EDD()->utils->get_time_zone( true ); } /** * Accept an EDD date object and get the UTC equivalent version of it. * The EDD date object passed-in can be in any timezone. The one you'll get back will be the UTC equivalent of that time. * This is useful when querying data from the tables by a user-defined date range, like "today". * * @since 3.0 * @param EDD\Utils\Date $edd_date_object The EDD Date object for which you wish to get the UTC equiavalent. * @return EDD\Utils\Date The EDD date object set at the UTC equivalent time. */ function edd_get_utc_equivalent_date( $edd_date_object ) { $instance_check = 'EDD\Utils\Date'; if ( ! $edd_date_object instanceof $instance_check ) { return false; } // Convert the timezone (and thus, also the time) from the WP/EDD Timezone to the UTC equivalent. $utc_timezone = new DateTimeZone( 'utc' ); $edd_date_object->setTimezone( $utc_timezone ); return $edd_date_object; } /** * Accept an EDD date object set in UTC, and get the WP/EDD Timezone equivalent version of it. * The EDD date object must be in UTC. The one you'll get back will be the WP timezone equivalent of that time. * This is useful when showing date information to the user, so that they see it in the proper timezone, instead of UTC. * * @since 3.0 * @param EDD\Utils\Date $edd_date_object The EDD Date object for which you wish to get the UTC equiavalent. * @return EDD\Utils\Date The EDD date object set at the UTC equivalent time. */ function edd_get_edd_timezone_equivalent_date_from_utc( $edd_date_object ) { $instance_check = 'EDD\Utils\Date'; if ( ! $edd_date_object instanceof $instance_check ) { return false; } // If you passed a date object to this function that isn't set to UTC, that is incorrect usage. if ( 'UTC' !== $edd_date_object->format( 'T' ) ) { return false; } // Convert the timezone (and thus, also the time) from UTC to the WP/EDD Timezone. $edd_timezone = new DateTimeZone( edd_get_timezone_id() ); $edd_date_object->setTimezone( $edd_timezone ); return $edd_date_object; } /** * Get the timezone abbreviation for the WordPress timezone setting. * * @since 3.0 * * @return string The abreviation for the current WordPress timezone setting. */ function edd_get_timezone_abbr() { $edd_timezone = edd_get_timezone_id(); $edd_date_object = EDD()->utils->date( 'now', $edd_timezone, true ); return $edd_date_object->format( 'T' ); } /** * Retrieves a date format string based on a given short-hand format. * * @since 3.0 * * @see \EDD_Utilities::get_date_format_string() * * @param string $format Shorthand date format string. Accepts 'date', 'time', 'mysql', or * 'datetime'. If none of the accepted values, the original value will * simply be returned. Default 'date' represents the value of the * 'date_format' option. * * @return string date_format()-compatible date format string. */ function edd_get_date_format( $format = 'date' ) { return EDD()->utils->get_date_format_string( $format ); } /** * Get the format used by jQuery UI Datepickers. * * Use this if you need to use placeholder or format attributes in input fields. * * This is a bit different than `edd_get_date_format()` because these formats * are exposed to users as hints and also used by jQuery UI so the Datepicker * knows what format it returns into it's connected input value. * * Previous to this function existing, all values were hard-coded, causing some * inconsistencies across admin-area screens. * * @see https://github.com/easydigitaldownloads/easy-digital-downloads/commit/e9855762892b6eec578b0a402f7950f22bd19632 * * @since 3.0 * * @param string $context The context we are getting the format for. Accepts 'display' or 'js'. * Use 'js' for use with jQuery UI Datepicker. Use 'display' for HTML attributes. * @return string */ function edd_get_date_picker_format( $context = 'display' ) { // What is the context that we are getting the picker format for? switch ( $context ) { // jQuery UI Datepicker does its own thing case 'js' : case 'javascript' : $retval = EDD()->utils->get_date_format_string( 'date-js' ); break; // Used to display in an attribute, placeholder, etc... case 'display' : default : $retval = EDD()->utils->get_date_format_string( 'date-attribute' ); break; } /** * Filter the date picker format, allowing for custom overrides * * @since 3.0 * * @param string $retval Date format for date picker * @param string $context The context this format is for */ return apply_filters( 'edd_get_date_picker_format', $retval, $context ); } /** * Return an array of values used to populate an hour dropdown * * @since 3.0 * * @return array */ function edd_get_hour_values() { return (array) apply_filters( 'edd_get_hour_values', array( '00' => '00', '01' => '01', '02' => '02', '03' => '03', '04' => '04', '05' => '05', '06' => '06', '07' => '07', '08' => '08', '09' => '09', '10' => '10', '11' => '11', '12' => '12', '13' => '13', '14' => '14', '15' => '15', '16' => '16', '17' => '17', '18' => '18', '19' => '19', '20' => '20', '21' => '21', '22' => '22', '23' => '23', '24' => '24' ) ); } /** * Return an array of values used to populate a minute dropdown * * @since 3.0 * * @return array */ function edd_get_minute_values() { return (array) apply_filters( 'edd_get_minute_values', array( '00' => '00', '01' => '01', '02' => '02', '03' => '03', '04' => '04', '05' => '05', '06' => '06', '07' => '07', '08' => '08', '09' => '09', '10' => '10', '11' => '11', '12' => '12', '13' => '13', '14' => '14', '15' => '15', '16' => '16', '17' => '17', '18' => '18', '19' => '19', '20' => '20', '21' => '21', '22' => '22', '23' => '23', '24' => '24', '25' => '25', '26' => '26', '27' => '27', '28' => '28', '29' => '29', '30' => '30', '31' => '31', '32' => '32', '33' => '33', '34' => '34', '35' => '35', '36' => '36', '37' => '37', '38' => '38', '39' => '39', '40' => '40', '41' => '41', '42' => '42', '43' => '43', '44' => '44', '45' => '45', '46' => '46', '47' => '47', '48' => '48', '49' => '49', '50' => '50', '51' => '51', '52' => '52', '53' => '53', '54' => '54', '55' => '55', '56' => '56', '57' => '57', '58' => '58', '59' => '59' ) ); } Offers – HigherGround420

Offers

All offers shown here are HG420 affiliates and Members. Your purchases support HG420 operations and research.

All hemp products, including Delta-8-THC, are now Legal and Available throughout the United States via the 2018 Farm Bill.
Scroll To Top

Scroll To Top

Cultivation Products (affiliate support)

Scroll To Top

Seeds (Affiliate Support)

Hey, wait!Subscribe to stay current on new TerpTypes!

Before you go, let us offer you a FREE subscription.

Thanks, I’m not interested

ajax-loader